...
Eroare Testare automată · Selenium WebDriver și Mocha

InvalidElementStateError: invalid element state: Element must be user-editable in order to clear it.

Pe scurt

clear() a fost apelat pe un element care nu e un câmp editabil: un label, un div, un span sau un input readonly / disabled. Găsește chiar câmpul (input, textarea) și verifică să fie activ și editabil înainte de clear() și sendKeys().

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

element.clear() golește valoarea unui câmp, la fel ca un utilizator care selectează textul și îl șterge. ChromeDriver acceptă comanda doar pe elemente pe care utilizatorul le poate edita: <input> de tip text (email, password, search, number...), <textarea> sau elemente contenteditable, care nu sunt disabled sau readonly. Pentru orice altceva răspunde invalid element state: Element must be user-editable in order to clear it.

Cauza obișnuită e locatorul: ai prins eticheta (label), containerul câmpului (div.form-group) sau un element afișat lângă el, nu input-ul propriu-zis. Altă cauză: câmpul e intenționat readonly (de exemplu un total calculat, un câmp precompletat blocat) sau disabled până la un alt pas. Pentru un câmp readonly, testul nu trebuie să-l golească: utilizatorul nu poate, deci verifică doar valoarea. În unele versiuni, biblioteca Selenium raportează aceeași situație ca ElementNotInteractableError.

De ce apare: cauzele frecvente

1Locatorul prinde eticheta

Greșit
JavaScript
const camp = await driver.findElement(By.css('label[for="search"]'));
await camp.clear();
Corect
JavaScript
const camp = await driver.findElement(By.css('[data-testid="search-input"]'));
await camp.clear();

Eticheta e doar text. clear() se aplică input-ului legat de ea.

2Câmpul e readonly

Greșit
JavaScript
const total = await driver.findElement(By.id('total'));
await total.clear();
Corect
JavaScript
const total = await driver.findElement(By.id('total'));
assert.strictEqual(await total.getAttribute('value'), '148,00');

Un câmp readonly nu poate fi editat de utilizator; testul îi verifică valoarea, nu o schimbă.

3Câmpul e dezactivat până la alt pas

Greșit
JavaScript
await driver.findElement(By.id('cod')).clear();
Corect
JavaScript
await driver.findElement(By.id('are-cod')).click();
await driver.findElement(By.id('cod')).clear();

Câmpul pentru cod devine editabil abia după bifa „Am un cod”. Urmează pașii utilizatorului.

Repară tu

Repară eroarea, direct în pagină

Testul Selenium caută din nou după ce golește câmpul pică cu invalid element state: Element must be user-editable in order to clear it.: locatorul prinde eticheta „Caută”, nu câmpul. Câmpul de căutare are data-testid="search-input". Repară locatorul, apoi testul golește câmpul, caută mouse (cu Enter) și afișează textul din results-count (1 produs).

Codul care dă eroarea
JavaScript
const { Builder, By, until, Key } = require('selenium-webdriver');
const assert = require('node:assert');

describe('Căutare', function () {
  this.timeout(10000);
  let driver;

  before(async function () {
    driver = await new Builder().forBrowser('chrome').build();
  });

  after(async function () {
    await driver.quit();
  });

  it('caută din nou după ce golește câmpul', async function () {
    await driver.get('http://localhost:3000/#/catalog');
    await driver.wait(until.elementLocated(By.css('[data-testid="product-card"]')), 5000);
    const camp = await driver.findElement(By.css('label[for="search"]'));
    await camp.clear();
    await camp.sendKeys('mouse', Key.ENTER);
  });
});
Indiciu

Eticheta e doar text; câmpul are un atribut de test.

Alte forme ale mesajului

  • ElementNotInteractableError: invalid element state: Element must be user-editable in order to clear it.
  • org.openqa.selenium.InvalidElementStateException: invalid element state: Element must be user-editable in order to clear it.
  • InvalidElementStateError: invalid element state: Element is not currently interactable and may not be manipulated

Cum o eviți pe viitor

  • Găsește câmpurile după atributul de test sau după id-ul input-ului, nu după etichetă sau container.
  • Verifică starea câmpului înainte de editare (isEnabled(), atributul readonly) când pagina o schimbă dinamic.
  • Pune locatorii câmpurilor într-un Page Object, verificați o singură dată.

Întrebări frecvente

sendKeys pe un label dă aceeași eroare?

Nu neapărat: sendKeys pe un element nefocusabil dă de obicei element not interactable. Cauza e aceeași, locatorul nu e câmpul.

Playwright are echivalentul?

Da: locator.fill / clear pe un element care nu e câmp dă Element is not an <input>, <textarea> or [contenteditable] element, iar pe un câmp readonly așteaptă și raportează element is not editable.

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.