Error: locator.press: Unknown key: "Ctrl"
Numele tastei din press() nu e unul pe care Playwright îl cunoaște. Tastele se scriu ca în standardul KeyboardEvent.key: Control (nu Ctrl), Enter, Escape (nu Esc), ArrowDown, Backspace; combinațiile cu +, de ex. Control+A sau ControlOrMeta+A ca să meargă și pe Mac.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
locator.press('Ctrl+A') și page.keyboard.press(...) primesc numele tastei. Playwright acceptă numele din standardul KeyboardEvent.key / code: Enter, Tab, Escape, Backspace, Delete, ArrowLeft, Home, PageDown, F1–F12, litere și cifre (a, KeyA, Digit1) și modificatorii Shift, Control, Alt, Meta, ControlOrMeta.
Abrevierile obișnuite din documentații pentru oameni nu sunt recunoscute: Ctrl, Esc, Del, Cmd, Return, Up. Mesajul Unknown key: "Ctrl" spune exact ce nume n-a fost înțeles.
Combinațiile se scriu cu +, fără spații: Control+Shift+K. Pentru „selectează tot” pe orice sistem, ControlOrMeta+A alege Control pe Windows și Linux și Meta (Cmd) pe macOS.
De ce apare: cauzele frecvente
1Abrevierea Ctrl în loc de Control
await cautare.press('Ctrl+A');await cautare.press('ControlOrMeta+A');Modificatorul se numește Control; ControlOrMeta merge și pe Mac.
2Esc în loc de Escape
await page.keyboard.press('Esc');await page.keyboard.press('Escape');Tasta are numele complet Escape.
3Spații în combinație
await camp.press('Shift + Tab');await camp.press('Shift+Tab');Combinația se scrie fără spații; cu spații, Playwright caută o tastă numită „ Tab”.
Repară eroarea, direct în pagină
Testul golesc căutarea cu tastatura scrie laptop în câmpul Caută din catalog, apoi vrea să selecteze tot textul și să-l șteargă cu tastatura. Pică imediat cu locator.press: Unknown key: "Ctrl". Repară combinația de taste ca testul să meargă și pe Windows, și pe macOS, iar câmpul să rămână gol.
import { test, expect } from '@playwright/test';
test('golesc căutarea cu tastatura', async ({ page }) => {
await page.goto('/#/catalog');
const cautare = page.getByLabel('Caută');
await cautare.fill('laptop');
await cautare.press('Ctrl+A');
await cautare.press('Backspace');
await expect(cautare).toHaveValue('');
});Indiciu
Modificatorul care alege singur între Control și Cmd se numește ControlOrMeta.
Reparația
import { test, expect } from '@playwright/test';
test('golesc căutarea cu tastatura', async ({ page }) => {
await page.goto('/#/catalog');
const cautare = page.getByLabel('Caută');
await cautare.fill('laptop');
await cautare.press('ControlOrMeta+A');
await cautare.press('Backspace');
await expect(cautare).toHaveValue('');
});De ce merge
Playwright nu cunoaște abrevierea Ctrl; modificatorul se numește Control. ControlOrMeta+A e varianta portabilă: pe Windows și Linux apasă Control+A, pe macOS Cmd+A, deci selectează textul pe orice sistem.
După selecție, Backspace șterge tot textul, iar toHaveValue('') verifică faptul că a rămas gol. Dacă scopul ar fi fost doar golirea câmpului, clear() ar fi fost suficient; aici testul verifică chiar comportamentul tastaturii.
Alte forme ale mesajului
Error: keyboard.press: Unknown key: "Esc"Error: locator.press: Unknown key: "Cmd"Error: keyboard.down: Unknown key: "Ctrl"
Cum o eviți pe viitor
Ține la îndemână lista de nume din documentația Playwright pentru keyboard.press și scrie mereu numele complete: Control, Escape, Delete, Enter. Pentru scurtături care trebuie să meargă pe Windows și pe Mac, folosește ControlOrMeta. Când vrei doar să golești un câmp, nu ai nevoie de tastatură: fill('') sau clear() fac asta direct.
Întrebări frecvente
Pe Mac, Control+A nu selectează textul. De ce?
Pe macOS scurtătura e Cmd+A, adică Meta+A. ControlOrMeta+A alege automat varianta potrivită sistemului pe care rulează testul.
Care e diferența dintre press și pressSequentially?
press apasă o tastă sau o combinație. pressSequentially('text') tastează un text literă cu literă, ca un utilizator, util când pagina reacționează la fiecare tastă.
Erori înrudite
TypeError: page.getByRol is not a function Ai apelat o metodă care nu există, de obicei din cauza unei greșeli de scriere: getByRol în loc de getByRole, getByLable, toHaveUrl. Corectează numele exact al metodei; literele mari contează, iar editorul cu autocomplete (VS Code) te ajută să le alegi corect. Error: locator.fill: Error: Input of type "checkbox" cannot be filled Ai folosit fill() pe o căsuță de bifat (sau pe un radio, buton, input de fișier). fill() e doar pentru câmpuri de text. Pentru checkbox și radio folosește check() / uncheck() / setChecked(), pentru butoane click(), iar pentru fișiere setInputFiles(). Error: expect(locator).toHaveValue(expected) failed Valoarea câmpului nu e cea așteptată. toHaveValue compară toată valoarea din input, textarea sau select, deci o parte din ea nu ajunge; scrie valoarea completă sau folosește o expresie regulată (de ex. /Ana/). Verifică și dacă ai ales câmpul corect. Î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.
