...
Eroare Testare automată · Structura testului: fixtures, hooks și importuri

Error: Tag must start with "@" symbol, got "smoke" instead.

Pe scurt

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ă @

Greșit
JavaScript
test('login reușit', { tag: 'smoke' }, async ({ page }) => { /* ... */ });
Corect
JavaScript
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ă

Greșit
JavaScript
test('checkout', { tag: ['@smoke', 'lent'] }, async ({ page }) => { /* ... */ });
Corect
JavaScript
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

Greșit
JavaScript
const tag = caz.tipuri;          // ['regresie']
test(caz.titlu, { tag }, async ({ page }) => { /* ... */ });
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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.

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.js cu export const SMOKE = '@smoke').
  • Folosește doar litere mici, ca filtrele --grep să fie previzibile.
  • Rulează npx playwright test --list --grep @smoke ca 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

← Toate erorile Testare automată

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.