Error: Tag must start with "@" symbol, got "smoke" instead.
Un tag dat în opțiunea tag a unui test sau describe nu începe cu @. Scrie { tag: '@smoke' } (sau ['@smoke', '@login']), nu { tag: 'smoke' }; filtrarea se face apoi cu npx playwright test --grep @smoke.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Din Playwright 1.42, testele pot primi tag-uri în al doilea argument: test('login', { tag: '@smoke' }, async ({ page }) => {...}). Tag-urile trebuie să înceapă cu @, ca să poată fi găsite cu --grep @smoke la fel ca tag-urile scrise direct în titlu. Când un tag nu respectă regula, Playwright oprește încărcarea fișierului cu Tag must start with "@" symbol, got "smoke" instead.
E o eroare la încărcare, nu la rulare: niciun test din fișier nu pornește, iar raportul indică linia cu test( sau test.describe(. Mesajul arată exact tag-ul greșit (got "smoke"). Apare des la migrarea din alte unelte (Cucumber, Jest) unde tag-urile se scriau altfel, sau când lista de tag-uri vine dintr-o variabilă / un fișier de date fără @. Regula se aplică și pe test.describe(..., { tag }).
De ce apare: cauzele frecvente
1Tag fără @
test('login reușit', { tag: 'smoke' }, async ({ page }) => { /* ... */ });test('login reușit', { tag: '@smoke' }, async ({ page }) => { /* ... */ });Tag-urile din opțiunea tag trebuie să înceapă cu @.
2Un singur tag greșit într-o listă
test('checkout', { tag: ['@smoke', 'lent'] }, async ({ page }) => { /* ... */ });test('checkout', { tag: ['@smoke', '@lent'] }, async ({ page }) => { /* ... */ });Fiecare element din listă e verificat; e suficient unul fără @ ca fișierul să nu se încarce.
3Tag-uri generate din date
const tag = caz.tipuri; // ['regresie']
test(caz.titlu, { tag }, async ({ page }) => { /* ... */ });const tag = caz.tipuri.map((t) => '@' + t);
test(caz.titlu, { tag }, async ({ page }) => { /* ... */ });Când tag-urile vin din date, adaugă @ la construirea lor.
Repară eroarea, direct în pagină
Fișierul nu se încarcă: Tag must start with "@" symbol, got "smoke" instead. Repară tag-urile celor două teste ca să fie valide (@smoke pentru pagina principală se deschide, @smoke și @catalog pentru catalogul are produse). Testele afișează apoi lista lor de tag-uri cu test.info().tags.
import { test, expect } from '@playwright/test';
test('pagina principală se deschide', { tag: 'smoke' }, async ({ page }) => {
await page.goto('/');
await expect(page.getByRole('heading', { level: 1 })).toBeVisible();
});
test('catalogul are produse', { tag: ['smoke', 'catalog'] }, async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
});Indiciu
Tag-urile din opțiunea tag au un prefix obligatoriu.
Reparația
import { test, expect } from '@playwright/test';
test('pagina principală se deschide', { tag: '@smoke' }, async ({ page }) => {
await page.goto('/');
await expect(page.getByRole('heading', { level: 1 })).toBeVisible();
console.log(test.info().tags);
});
test('catalogul are produse', { tag: ['@smoke', '@catalog'] }, async ({ page }) => {
await page.goto('/#/catalog');
await expect(page.getByTestId('product-card')).toHaveCount(8);
console.log(test.info().tags);
});De ce merge
Opțiunea tag cere ca fiecare tag să înceapă cu @, iar Playwright verifică regula când încarcă fișierul. 'smoke' și 'catalog' fără @ au oprit încărcarea, deci niciun test nu a rulat.
Cu '@smoke' și ['@smoke', '@catalog'], fișierul se încarcă, testele rulează, iar test.info().tags întoarce lista de tag-uri. Reporterul afișează tag-urile după titlu, iar --grep @smoke ar selecta ambele teste.
Alte forme ale mesajului
Error: Tag must start with "@" symbol, got "regresie" instead.Error: details.tag: Tag must start with '@'
Cum o eviți pe viitor
- Ține lista de tag-uri ale proiectului într-un singur loc (de exemplu un fișier
tags.jscuexport const SMOKE = '@smoke'). - Folosește doar litere mici, ca filtrele
--grepsă fie previzibile. - Rulează
npx playwright test --list --grep @smokeca să vezi ce teste prinde un tag.
Întrebări frecvente
Merge și tag-ul scris în titlu?
Da: test('login reușit @smoke', ...) e varianta veche și încă funcționează cu --grep. Opțiunea tag e mai curată, fiindcă nu schimbă titlul testului.
Cum rulez testele fără un anumit tag?
Cu --grep-invert @lent, sau în config cu grepInvert: /@lent/. Pentru a combina, --grep "@smoke|@login" rulează testele care au oricare dintre tag-uri.
Erori înrudite
Error: Playwright Test did not expect test() to be called here. Ai apelat test() în interiorul altui test sau al unui hook. Testele se declară doar la nivelul fișierului sau în test.describe(); pentru pași comuni folosește test.beforeEach, iar pentru grupare test.describe. Mesajul mai apare când două versiuni de @playwright/test sunt instalate în proiect. Error: No tests found Playwright nu a găsit niciun test de rulat: fișierul nu se potrivește cu testMatch (trebuie .spec.js / .test.js), e în afara testDir, filtrul --grep nu prinde nimic sau testele sunt generate dintr-o listă goală. Verifică numele și locul fișierului, apoi lista de date din care creezi testele. 1 flaky Raportul spune „1 flaky” când un test a picat, apoi a trecut la reîncercare (retries). Cauza tipică: testul citește pagina după o pauză fixă (waitForTimeout) sau cu valori de moment (count(), textContent(), isVisible()). Înlocuiește-le cu aserțiuni care așteaptă: toHaveCount, toHaveText, toBeVisible. Învață Testare automată de la zero, cu exerciții la fiecare lecție
Curs Test Automation (Playwright și Selenium): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.
