MCPcopy Create free account
hub / github.com/SeleniumHQ/selenium / submit

Method submit

py/selenium/webdriver/remote/webelement.py:119–141  ·  view source on GitHub ↗

Submits a form. Example: form = driver.find_element(By.NAME, "login") form.submit()

(self)

Source from the content-addressed store, hash-verified

117 self._execute(Command.CLICK_ELEMENT)
118
119 def submit(self) -> None:
120 """Submits a form.
121
122 Example:
123 form = driver.find_element(By.NAME, "login")
124 form.submit()
125 """
126 script = (
127 "/* submitForm */var form = arguments[0];\n"
128 'while (form.nodeName != "FORM" && form.parentNode) {\n'
129 " form = form.parentNode;\n"
130 "}\n"
131 "if (!form) { throw Error('Unable to find containing form element'); }\n"
132 "if (!form.ownerDocument) { throw Error('Unable to find owning document'); }\n"
133 "var e = form.ownerDocument.createEvent('Event');\n"
134 "e.initEvent('submit', true, true);\n"
135 "if (form.dispatchEvent(e)) { HTMLFormElement.prototype.submit.call(form) }\n"
136 )
137
138 try:
139 self._parent.execute_script(script, self)
140 except JavascriptException as exc:
141 raise WebDriverException("To submit an element, it must be nested inside a form element") from exc
142
143 def clear(self) -> None:
144 """Clears the text if it's a text entry element.

Callers

nothing calls this directly

Calls 2

WebDriverExceptionClass · 0.90
execute_scriptMethod · 0.45

Tested by

no test coverage detected