text_to_be_present_in_element_value(locator: Tuple[str, str], text_: str) ： 判断某个元素中的value属性是否包含了预期字符串；

frame_to_be_available_and_switch_to_it(locator: Union[Tuple[str, str], str]) ： 判断该表单是否可以切换进去，如果可以，返回True并switch进去，否则返回False；

invisibility_of_element_located(locator: Union[WebElement, Tuple[str, str]]) ： 判断某个元素是否不存在与DOM树中或不可见

element_to_be_clickable( mark: Union[WebElement, Tuple[str, str]]) ： 判断元素是否可见并是可以点击的，如果元素存在且可点击，则返回元素，如果元素存在但不可点击，则返回False；

element_to_be_selected(element: WebElement) ： 判断某个元素是否被选中，一般用在下拉列表，传入element元素；

element_selection_state_to_be(element: WebElement, is_selected: bool) ： 判断某个元素的选中状态是否符合预期，方法参数是element和 is_selected；

element_located_selection_state_to_be(locator: Tuple[str, str], is_selected: bool) ： 与element_selection_state_to_be()作用一样，只是方法参数不同，方法参数是located和 is_selected

alert_is_present() ： 按断页面上是否存在alert警告；

from time import sleep
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.support.wait import WebDriverWait
driver = webdriver.Edge()
driver.get("https://www.baidu.com")
driver.maximize_window()
# 设置隐式等待--这是全局的，针对所有元素查找操作都有效
driver.implicitly_wait(3)
# 直到元素可点击
el = WebDriverWait(driver=driver,timeout=10,poll_frequency=1).until(EC.element_to_be_clickable((By.ID,"kw")))
print(type(el)) # <class 'selenium.webdriver.remote.webelement.WebElement'>
el.send_keys("hello")
query = driver.find_element(By.ID,"kw")
print(type(query)) # <class 'selenium.webdriver.remote.webelement.WebElement'>
isurl = WebDriverWait(driver,10,1).until(EC.url_contains("bai"))
print(isurl) # True
sleep(3)
driver.quit()
二、隐式等待与显示等待的区别和细节
隐式等待（driver.implicitly_wait(time_in_seconds)）
定义：设置一个全局的等待时间，在该时间范围内，Selenium 将等待页面的所有元素可见或可操作。
使用方式：通过 driver.implicitly_wait(time_in_seconds) 来设置等待时间，time_in_seconds 为等待的时间（以秒为单位）。
应用场景：适用于等待页面上的所有元素，在页面加载完成之前进行等待，并不需要为每个元素单独设置等待时间。
关注的是元素加载到DOM中，也就是元素存在于页面结构中，并且可以通过find_element方法来定位到元素。
隐式等待并不关注元素是否在页面上可见或者是否已经渲染出来，它的着重点在于等待元素的出现和可定位性。如果元素在指定的等待时间内成功被定位到，WebDriver会立即继续执行代码。但如果超过了设置的等待时间，仍未能找到元素，则会抛出 NoSuchElementException 异常。
隐式等待是一种全局设置，对于整个WebDriver的生命周期都起作用。在设置了隐式等待之后，WebDriver会在尝试在每个定位元素时等待一定的时间，直到找到符合定位条件的元素，或者等待时间超过了设置的等待时间。
初步解决方案：
1、能想到的第一解决方案就是使用显示等待然后给excepted_conditions 条件，直到按钮可点击，但是这是无法实现的，因为按钮可点击的条件可以实现，但是并不能实现双击；
2、调用两次click点击实现双击，这种方式虽然能解决问题，但是略显不高级！
初步解决方案代码如下：
使用两次click实现点击两次
import time
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support import expected_conditions
from selenium.webdriver.support.wait import WebDriverWait
driver = webdriver.Edge()
driver.maximize_window()
driver.get("https://vip.ceshiren.com/#/ui_study/frame")
driver.implicitly_wait(3)
# 使用显示等待，条件是这个按钮可点击，它会返回可点击的元素，然后进行点击试试
WebDriverWait(driver,10,2).until(expected_conditions.element_to_be_clickable((By.XPATH,"//*[@id='primary_btn']")),"按钮不可点击").click()
# 上面的点击事件确实触发了，在屏幕上确实可见，但是却没有达到要求点击两次，那就再来点击一次
WebDriverWait(driver,10,2).until(expected_conditions.element_to_be_clickable((By.XPATH,"//*[@id='primary_btn']")),"按钮不可点击").click()
time.sleep(10)
driver.quit()
3、私人定制等待条件
针对上面按钮的需求，自定义一个until的等待条件实现需要点击两次按钮的点击，甚至是需要点击多次才能点击成功的按钮的点击事件；
1、模仿expected_conditions中方法的定义模式，定义一个内函数和外函数；
2、外函数接收两个参数，第一个是需要点击的按钮定位器，第二个是下一个页面用于确认点击成功跳转过去的某个元素的定位器；
3、内函数接收一个参数，webdirver的对象，因为里面需要用到find_element方法，同时until源码中也传了一个参数(value = method(self._driver)),所以需要webdirver对象；
4、内函数返回定位到的下个页面用于确认点击成功并跳过去了的页面中的元素；
原理：仔细研究until方法和expected_conditions中的方法；
1、until方法的第一个参数需要的是一个函数引用，所以expected_conditions中的方法都返回了内函数的引用；
2、until中会通过死循环轮询去调用“内函数”，而自定义条件的内函数返回的是定位到的元素，在until中：
如果这个“内函数返回真”，也就是定位到了元素就会返回这个定位到的元素；
如果“内函数定位的时候抛出了异常”，until会捕获这个异常并且开始轮巡再次去调用“内函数”，直到”内函数找到元素“或者是超时时间达到最终抛出异常；
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.wait import WebDriverWait
# 模仿expected_conditions自定义一个until的条件函数实现对某个按钮的多次点击操作
# 外函数，这是需要传给until的函数
def repeatedly_click(click_element_locator: tuple,next_page_element_locator:tuple):
    # 内函数，这是until中真正用到的函数，里面是元素定位逻辑，需要一个webdirver对象作为参数
    # 因为通过源码知道until中调用了内函数并且返回了一个value，我们这里value是个webelement对象，不是bool值
    def inner(driver: webdriver):
        # 直接定位元素并点击，但是可能会抛出异常，那就做异常处理
            # find_element需要两个参数，但传进来的是一个元组，所以使用自动解包方式(*click_element_locator)传参
            driver.find_element(*click_element_locator).click()
        except Exception as e:
            # 出现了异常不要怕，直接返回这个异常，因为until中接收了异常并捕获处理，until中代码--try：value = method(self._driver)
            # until捕获了异常会进入轮询
            return e
        # 内函数返回定位的下个页面的元素，因为是定位，必然可能会有异常，但是不要怕，这个异常until会处理
        # 直到超时或者找到元素之后返回这个元素，until结束，代码继续往下执行
        # until如果还抛出异常，那说明要么等待时间不够，要么定位器写错了，要么就是这个按钮压根就不可点击等等，需要具体问题具体分析
        # until如果返回了真值，那说明下个页面的元素是找到了，说明多次点击成功
        return driver.find_element(*next_page_element_locator)
    # 外函数返回内函数的引用
    return inner
def check_webdriverwait():
    driver = webdriver.Edge()
    driver.maximize_window()
    driver.get("https://vip.ceshiren.com/#/ui_study/frame")
    # 还是来个隐式等待吧
    driver.implicitly_wait(3)
    # 将自定义的until等待条件传给until
    click_element_locator = (By.XPATH,"//*[text()='点击两次响应']") # 多练练xpath语法
    next_page_element_locator = (By.XPATH,"//*[text()='该弹框点击两次后才会弹出']")
    WebDriverWait(driver,10,2).until(method=repeatedly_click(click_element_locator,next_page_element_locator),message="自定义多次点击条件出没出问题")
    # 睡上几秒查看效果
    time.sleep(5)
    driver.quit()
if __name__ == '__main__':
    check_webdriverwait()