testing: detectores de UI como pacote consumível (faixa vazia, gutter, sobreposição, texto cru, hierarquia de ações, CLS com origem, foco após toque)

オープン
#1,290 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
playwright, typescript
領域
testing

調査の方向性

Read discussion #1087 §2.5 and the consumer request atlas#215 first; they define the detectors and the acceptance run. The deliverable is a stable export such as @codeatlasdev/ui/testing/detectors with the detect(page, opts) signature and one function per detector, each backed by a failing and a corrected fixture. The empty-band case (490 px of blank on a 390x844 viewport) is the explicit acceptance test; run everything through Playwright on Chromium and WebKit at 390 and 1440 px in light and dark. Done means atlas#215 passes without the detectors depending on kit DOM code.

索引モデルが issue の本文から書いたものです。

説明

Pedido de codeatlasdev/atlas#215 (épico codeatlasdev/atlas#168). A Atlas Crew precisa rodar, numa página aberta pelo Playwright (Chromium e WebKit, 390 e 1440 px, claro e escuro), os detectores descritos na discussão #1087 §2.5, sem copiar a lógica para o Atlas.

O que falta aqui

Um export estável, por exemplo @codeatlasdev/ui/testing/detectors, com uma função por detector e uma que roda todos:

type Finding = { detector: string; severity: "error" | "warn"; message: string; rect?: DOMRectInit; selector?: string };
export function detect(page: Page | Window, opts?: { only?: string[] }): Promise<Finding[]>;

Detectores (cada um com fixture que falha e fixture corrigida):

  1. Faixa vazia na página inteira: banda horizontal sem conteúdo acima de um limite (ex.: 490 px de vazio num 390x844) — ver #1084.
  2. Gutter < 12 px no celular — ver #1154.
  3. Sobreposição de irmãos (caixas que se cobrem sem ser overlay).
  4. Texto cru: ids, snake_case/kebab-case em títulos e rótulos.
  5. Hierarquia de ações: mais de uma ação primária visível no mesmo grupo.
  6. CLS com origem: deslocamento acima do limite, com o elemento que causou — ver #1068 e #974.
  7. Foco após toque: o elemento ativado perde o foco ou ele vai para o body — ver #1229.

Por que no ui

O Atlas e qualquer app do kit usam as mesmas regras; duplicá-las no Atlas faria as duas divergirem.

Aceite (o que o Atlas vai testar)

  • O detector de faixa vazia reprova uma fixture com faixa de 490 px e aprova a corrigida (codeatlasdev/atlas#215).
  • Rodam no Chromium e no WebKit (WebKit é o motor do Atlas Desktop e do Safari do iPhone).
  • Sem dependência de DOM do kit: funcionam em qualquer página (o Atlas roda em apps de clientes).
主要言語
TypeScript
スター
6
フォーク
3
平均マージ
5時間 21分
マージ済み PR(30日)
378

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

codeatlasdev/ui のほかの issue

codeatlasdev/ui の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。