...
Eroare Testare automată · Acțiuni pe elemente: click, fill, check, selectOption, press

Error: locator.press: Unknown key: "Ctrl"

Pe scurt

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

Greșit
JavaScript
await cautare.press('Ctrl+A');
Corect
JavaScript
await cautare.press('ControlOrMeta+A');

Modificatorul se numește Control; ControlOrMeta merge și pe Mac.

2Esc în loc de Escape

Greșit
JavaScript
await page.keyboard.press('Esc');
Corect
JavaScript
await page.keyboard.press('Escape');

Tasta are numele complet Escape.

3Spații în combinație

Greșit
JavaScript
await camp.press('Shift + Tab');
Corect
JavaScript
await camp.press('Shift+Tab');

Combinația se scrie fără spații; cu spații, Playwright caută o tastă numită „ Tab”.

Repară tu

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.

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

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

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