@@ -453,389 +453,6 @@ def title(self) -> str:
453
453
resp = self .execute (Command .GET_TITLE )
454
454
return resp ['value' ] if resp ['value' ] else ""
455
455
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
-
839
456
def pin_script (self , script , script_key = None ) -> ScriptKey :
840
457
"""
841
458
0 commit comments