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

To submit an element, it must be nested inside a form element

Pe scurt

Ai apelat submit() pe un element care nu e într-un <form>, deci Selenium nu are ce formular să trimită. Aplicațiile moderne pornesc acțiunea din JavaScript (Enter, click pe buton), fără formular. Fă ce face utilizatorul: sendKeys(..., Key.ENTER) sau click pe butonul de trimitere.

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

Ce înseamnă

element.submit() caută formularul care conține elementul (urcând prin părinți până la <form>) și îl trimite. Dacă elementul nu e în niciun formular, nu are ce trimite: Selenium oprește comanda cu To submit an element, it must be nested inside a form element (în Python, ca WebDriverException; în laborator, ca UnsupportedOperationError). În unele versiuni JavaScript mesajul apare ca javascript error: Unable to find containing form element.

Cazul tipic: o căutare sau un filtru dintr-o aplicație SPA (React, Vue) care ascultă tasta Enter pe input sau click pe un buton, fără <form>. Și chiar când există formular, submit() trimite formularul direct, fără evenimentul de click pe buton, deci validările legate de buton pot fi sărite. De aceea, varianta apropiată de utilizator e mereu mai bună: sendKeys(text, Key.ENTER) sau click pe buton.

De ce apare: cauzele frecvente

1Câmp de căutare fără formular

Greșit
JavaScript
const cauta = await driver.findElement(By.css('[data-testid="search-input"]'));
await cauta.sendKeys('mouse');
await cauta.submit();
Corect
JavaScript
const cauta = await driver.findElement(By.css('[data-testid="search-input"]'));
await cauta.sendKeys('mouse', Key.ENTER);

Aplicația ascultă Enter pe câmp. Tasta e exact ce face utilizatorul.

2submit() pe butonul din afara formularului

Greșit
JavaScript
await driver.findElement(By.css('#trimite')).submit();
Corect
JavaScript
await driver.findElement(By.css('#trimite')).click();

Un buton în afara formularului se apasă. Click-ul declanșează și validările legate de el.

Repară tu

Repară eroarea, direct în pagină

Testul Selenium caută un mouse pică cu To submit an element, it must be nested inside a form element. Câmpul de căutare din catalog (search-input) nu e într-un formular: aplicația caută la Enter. Repară trimiterea, apoi testul așteaptă textul 1 produs în results-count și îl afișează.

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ă un mouse', async function () {
    await driver.get('http://localhost:3000/#/catalog');
    await driver.wait(until.elementLocated(By.css('[data-testid="product-card"]')), 5000);
    const cauta = await driver.findElement(By.css('[data-testid="search-input"]'));
    await cauta.sendKeys('mouse');
    await cauta.submit();
    const numar = await driver.findElement(By.css('[data-testid="results-count"]'));
    await driver.wait(until.elementTextIs(numar, '1 produs'), 5000);
    console.log(await numar.getText());
  });
});
Indiciu

Ce tastă apasă utilizatorul ca să caute?

Alte forme ale mesajului

  • selenium.common.exceptions.WebDriverException: Message: To submit an element, it must be nested inside a form element
  • UnsupportedOperationError: To submit an element, it must be nested inside a form element
  • JavascriptError: javascript error: Unable to find containing form element

Cum o eviți pe viitor

  • Nu folosi submit(); trimite formularele ca utilizatorul: Enter în câmp sau click pe buton.
  • Verifică după trimitere efectul vizibil (rezultatele, mesajul), cu driver.wait(until...).
  • În Playwright, echivalentul e locator.press('Enter') sau click() pe buton.
  • Uită-te în HTML dacă există un <form>: în aplicațiile SPA lipsește des.

Întrebări frecvente

submit() și click pe buton fac același lucru?

Nu întotdeauna. submit() trimite formularul direct; click-ul trece prin evenimentele butonului (click, validări). Testul cu click e mai aproape de ce face omul.

Key.ENTER merge și în câmpurile din formular?

Da: Enter într-un câmp text dintr-un formular declanșează trimiterea implicită, ca în browser.

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.