Skip to content

Commit 4bbb7c2

Browse files
authored
[py]: remove deprecated find_element_by_ methods (#10712)
1 parent 38e8963 commit 4bbb7c2

File tree

4 files changed

+1
-890
lines changed

4 files changed

+1
-890
lines changed

py/selenium/webdriver/remote/webdriver.py

Lines changed: 0 additions & 383 deletions
Original file line numberDiff line numberDiff line change
@@ -453,389 +453,6 @@ def title(self) -> str:
453453
resp = self.execute(Command.GET_TITLE)
454454
return resp['value'] if resp['value'] else ""
455455

456-
def find_element_by_id(self, id_) -> WebElement:
457-
"""Finds an element by id.
458-
459-
:Args:
460-
- id\\_ - The id of the element to be found.
461-
462-
:Returns:
463-
- WebElement - the element if it was found
464-
465-
:Raises:
466-
- NoSuchElementException - if the element wasn't found
467-
468-
:Usage:
469-
::
470-
471-
element = driver.find_element_by_id('foo')
472-
"""
473-
warnings.warn(
474-
"find_element_by_* commands are deprecated. Please use find_element() instead",
475-
DeprecationWarning,
476-
stacklevel=2,
477-
)
478-
return self.find_element(by=By.ID, value=id_)
479-
480-
def find_elements_by_id(self, id_) -> List[WebElement]:
481-
"""
482-
Finds multiple elements by id.
483-
484-
:Args:
485-
- id\\_ - The id of the elements to be found.
486-
487-
:Returns:
488-
- list of WebElement - a list with elements if any was found. An
489-
empty list if not
490-
491-
:Usage:
492-
::
493-
494-
elements = driver.find_elements_by_id('foo')
495-
"""
496-
warnings.warn(
497-
"find_elements_by_id is deprecated. Please use find_elements(by=By.ID, value=id_) instead",
498-
DeprecationWarning,
499-
stacklevel=2,
500-
)
501-
return self.find_elements(by=By.ID, value=id_)
502-
503-
def find_element_by_xpath(self, xpath) -> WebElement:
504-
"""
505-
Finds an element by xpath.
506-
507-
:Args:
508-
- xpath - The xpath locator of the element to find.
509-
510-
:Returns:
511-
- WebElement - the element if it was found
512-
513-
:Raises:
514-
- NoSuchElementException - if the element wasn't found
515-
516-
:Usage:
517-
::
518-
519-
element = driver.find_element_by_xpath('//div/td[1]')
520-
"""
521-
warnings.warn(
522-
"find_element_by_xpath is deprecated. Please use find_element(by=By.XPATH, value=xpath) instead",
523-
DeprecationWarning,
524-
stacklevel=2,
525-
)
526-
return self.find_element(by=By.XPATH, value=xpath)
527-
528-
def find_elements_by_xpath(self, xpath) -> List[WebElement]:
529-
"""
530-
Finds multiple elements by xpath.
531-
532-
:Args:
533-
- xpath - The xpath locator of the elements to be found.
534-
535-
:Returns:
536-
- list of WebElement - a list with elements if any was found. An
537-
empty list if not
538-
539-
:Usage:
540-
::
541-
542-
elements = driver.find_elements_by_xpath("//div[contains(@class, 'foo')]")
543-
"""
544-
warnings.warn(
545-
"find_elements_by_xpath is deprecated. Please use find_elements(by=By.XPATH, value=xpath) instead",
546-
DeprecationWarning,
547-
stacklevel=2,
548-
)
549-
return self.find_elements(by=By.XPATH, value=xpath)
550-
551-
def find_element_by_link_text(self, link_text) -> WebElement:
552-
"""
553-
Finds an element by link text.
554-
555-
:Args:
556-
- link_text: The text of the element to be found.
557-
558-
:Returns:
559-
- WebElement - the element if it was found
560-
561-
:Raises:
562-
- NoSuchElementException - if the element wasn't found
563-
564-
:Usage:
565-
::
566-
567-
element = driver.find_element_by_link_text('Sign In')
568-
"""
569-
warnings.warn(
570-
"find_element_by_link_text is deprecated. Please use find_element(by=By.LINK_TEXT, value=link_text) instead",
571-
DeprecationWarning,
572-
stacklevel=2,
573-
)
574-
return self.find_element(by=By.LINK_TEXT, value=link_text)
575-
576-
def find_elements_by_link_text(self, text) -> List[WebElement]:
577-
"""
578-
Finds elements by link text.
579-
580-
:Args:
581-
- link_text: The text of the elements to be found.
582-
583-
:Returns:
584-
- list of webelement - a list with elements if any was found. an
585-
empty list if not
586-
587-
:Usage:
588-
::
589-
590-
elements = driver.find_elements_by_link_text('Sign In')
591-
"""
592-
warnings.warn(
593-
"find_elements_by_link_text is deprecated. Please use find_elements(by=By.LINK_TEXT, value=text) instead",
594-
DeprecationWarning,
595-
stacklevel=2,
596-
)
597-
return self.find_elements(by=By.LINK_TEXT, value=text)
598-
599-
def find_element_by_partial_link_text(self, link_text) -> WebElement:
600-
"""
601-
Finds an element by a partial match of its link text.
602-
603-
:Args:
604-
- link_text: The text of the element to partially match on.
605-
606-
:Returns:
607-
- WebElement - the element if it was found
608-
609-
:Raises:
610-
- NoSuchElementException - if the element wasn't found
611-
612-
:Usage:
613-
::
614-
615-
element = driver.find_element_by_partial_link_text('Sign')
616-
"""
617-
warnings.warn(
618-
"find_element_by_partial_link_text is deprecated. Please use find_element(by=By.PARTIAL_LINK_TEXT, value=link_text) instead",
619-
DeprecationWarning,
620-
stacklevel=2,
621-
)
622-
return self.find_element(by=By.PARTIAL_LINK_TEXT, value=link_text)
623-
624-
def find_elements_by_partial_link_text(self, link_text) -> List[WebElement]:
625-
"""
626-
Finds elements by a partial match of their link text.
627-
628-
:Args:
629-
- link_text: The text of the element to partial match on.
630-
631-
:Returns:
632-
- list of webelement - a list with elements if any was found. an
633-
empty list if not
634-
635-
:Usage:
636-
::
637-
638-
elements = driver.find_elements_by_partial_link_text('Sign')
639-
"""
640-
warnings.warn(
641-
"find_elements_by_partial_link_text is deprecated. Please use find_elements(by=By.PARTIAL_LINK_TEXT, value=link_text) instead",
642-
DeprecationWarning,
643-
stacklevel=2,
644-
)
645-
return self.find_elements(by=By.PARTIAL_LINK_TEXT, value=link_text)
646-
647-
def find_element_by_name(self, name) -> WebElement:
648-
"""
649-
Finds an element by name.
650-
651-
:Args:
652-
- name: The name of the element to find.
653-
654-
:Returns:
655-
- WebElement - the element if it was found
656-
657-
:Raises:
658-
- NoSuchElementException - if the element wasn't found
659-
660-
:Usage:
661-
::
662-
663-
element = driver.find_element_by_name('foo')
664-
"""
665-
warnings.warn(
666-
"find_element_by_name is deprecated. Please use find_element(by=By.NAME, value=name) instead",
667-
DeprecationWarning,
668-
stacklevel=2,
669-
)
670-
return self.find_element(by=By.NAME, value=name)
671-
672-
def find_elements_by_name(self, name) -> List[WebElement]:
673-
"""
674-
Finds elements by name.
675-
676-
:Args:
677-
- name: The name of the elements to find.
678-
679-
:Returns:
680-
- list of webelement - a list with elements if any was found. an
681-
empty list if not
682-
683-
:Usage:
684-
::
685-
686-
elements = driver.find_elements_by_name('foo')
687-
"""
688-
warnings.warn(
689-
"find_elements_by_name is deprecated. Please use find_elements(by=By.NAME, value=name)=By.NAME, value=name) instead",
690-
DeprecationWarning,
691-
stacklevel=2,
692-
)
693-
return self.find_elements(by=By.NAME, value=name)
694-
695-
def find_element_by_tag_name(self, name) -> WebElement:
696-
"""
697-
Finds an element by tag name.
698-
699-
:Args:
700-
- name - name of html tag (eg: h1, a, span)
701-
702-
:Returns:
703-
- WebElement - the element if it was found
704-
705-
:Raises:
706-
- NoSuchElementException - if the element wasn't found
707-
708-
:Usage:
709-
::
710-
711-
element = driver.find_element_by_tag_name('h1')
712-
"""
713-
warnings.warn(
714-
"find_element_by_tag_name is deprecated. Please use find_element(by=By.TAG_NAME, value=name) instead",
715-
DeprecationWarning,
716-
stacklevel=2,
717-
)
718-
return self.find_element(by=By.TAG_NAME, value=name)
719-
720-
def find_elements_by_tag_name(self, name) -> List[WebElement]:
721-
"""
722-
Finds elements by tag name.
723-
724-
:Args:
725-
- name - name of html tag (eg: h1, a, span)
726-
727-
:Returns:
728-
- list of WebElement - a list with elements if any was found. An
729-
empty list if not
730-
731-
:Usage:
732-
::
733-
734-
elements = driver.find_elements_by_tag_name('h1')
735-
"""
736-
warnings.warn(
737-
"find_elements_by_tag_name is deprecated. Please use find_elements(by=By.TAG_NAME, value=name) instead",
738-
DeprecationWarning,
739-
stacklevel=2,
740-
)
741-
return self.find_elements(by=By.TAG_NAME, value=name)
742-
743-
def find_element_by_class_name(self, name) -> WebElement:
744-
"""
745-
Finds an element by class name.
746-
747-
:Args:
748-
- name: The class name of the element to find.
749-
750-
:Returns:
751-
- WebElement - the element if it was found
752-
753-
:Raises:
754-
- NoSuchElementException - if the element wasn't found
755-
756-
:Usage:
757-
::
758-
759-
element = driver.find_element_by_class_name('foo')
760-
"""
761-
warnings.warn(
762-
"find_element_by_class_name is deprecated. Please use find_element(by=By.CLASS_NAME, value=name) instead",
763-
DeprecationWarning,
764-
stacklevel=2,
765-
)
766-
return self.find_element(by=By.CLASS_NAME, value=name)
767-
768-
def find_elements_by_class_name(self, name) -> List[WebElement]:
769-
"""
770-
Finds elements by class name.
771-
772-
:Args:
773-
- name: The class name of the elements to find.
774-
775-
:Returns:
776-
- list of WebElement - a list with elements if any was found. An
777-
empty list if not
778-
779-
:Usage:
780-
::
781-
782-
elements = driver.find_elements_by_class_name('foo')
783-
"""
784-
warnings.warn(
785-
"find_elements_by_class_name is deprecated. Please use find_elements(by=By.CLASS_NAME, value=name) instead",
786-
DeprecationWarning,
787-
stacklevel=2,
788-
)
789-
return self.find_elements(by=By.CLASS_NAME, value=name)
790-
791-
def find_element_by_css_selector(self, css_selector) -> WebElement:
792-
"""
793-
Finds an element by css selector.
794-
795-
:Args:
796-
- css_selector - CSS selector string, ex: 'a.nav#home'
797-
798-
:Returns:
799-
- WebElement - the element if it was found
800-
801-
:Raises:
802-
- NoSuchElementException - if the element wasn't found
803-
804-
:Usage:
805-
::
806-
807-
element = driver.find_element_by_css_selector('#foo')
808-
"""
809-
warnings.warn(
810-
"find_element_by_css_selector is deprecated. Please use find_element(by=By.CSS_SELECTOR, value=css_selector) instead",
811-
DeprecationWarning,
812-
stacklevel=2,
813-
)
814-
return self.find_element(by=By.CSS_SELECTOR, value=css_selector)
815-
816-
def find_elements_by_css_selector(self, css_selector) -> List[WebElement]:
817-
"""
818-
Finds elements by css selector.
819-
820-
:Args:
821-
- css_selector - CSS selector string, ex: 'a.nav#home'
822-
823-
:Returns:
824-
- list of WebElement - a list with elements if any was found. An
825-
empty list if not
826-
827-
:Usage:
828-
::
829-
830-
elements = driver.find_elements_by_css_selector('.foo')
831-
"""
832-
warnings.warn(
833-
"find_elements_by_css_selector is deprecated. Please use find_elements(by=By.CSS_SELECTOR, value=css_selector) instead",
834-
DeprecationWarning,
835-
stacklevel=2,
836-
)
837-
return self.find_elements(by=By.CSS_SELECTOR, value=css_selector)
838-
839456
def pin_script(self, script, script_key=None) -> ScriptKey:
840457
"""
841458

0 commit comments

Comments
 (0)