To submit an element, it must be nested inside a form element
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
const cauta = await driver.findElement(By.css('[data-testid="search-input"]'));
await cauta.sendKeys('mouse');
await cauta.submit();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
await driver.findElement(By.css('#trimite')).submit();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ă 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ă.
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?
Reparația
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', Key.ENTER);
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());
});
});De ce merge
submit() căuta un <form> în jurul câmpului și nu găsea niciunul, deci Selenium a refuzat comanda. Aplicația pornește căutarea când primește Enter în câmp, așa că sendKeys('mouse', Key.ENTER) face exact ce face utilizatorul. until.elementTextIs așteaptă rezultatul filtrării înainte de afișare.
Alte forme ale mesajului
selenium.common.exceptions.WebDriverException: Message: To submit an element, it must be nested inside a form elementUnsupportedOperationError: To submit an element, it must be nested inside a form elementJavascriptError: 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')sauclick()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
ElementNotInteractableError: element not interactable Selenium a găsit elementul, dar nu poate da click sau scrie în el: e ascuns (display:none, hidden, într-un meniu închis), are dimensiune zero sau încă nu e afișat. Fă întâi pasul care îl afișează (deschide meniul) și așteaptă-l cu until.elementIsVisible. TimeoutError: Waiting until element text is
Wait timed out after 5000ms until.elementTextIs a așteptat ca textul elementului să fie exact cel dat, dar nu a ajuns niciodată la el. Comparația e exactă: „2” nu e „2 produse”. Folosește textul complet, until.elementTextContains pentru o parte din el, sau verifică dacă acțiunea care schimbă textul chiar a avut loc. JavascriptError: javascript error: Cannot read properties of null (reading 'textContent') Scriptul rulat cu driver.executeScript a aruncat o eroare în pagină: aici, document.querySelector nu a găsit elementul și a întors null. Corectează selectorul din script (sau așteaptă elementul înainte) ori, mai bine, citește valoarea cu findElement + getText. Î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.
