自动化测试工具playwright中文文档-------21.扩展性

自定义选择器引擎

Playwright 支持自定义选择器引擎，这些引擎可以通过 selectors.register() 方法进行注册。

选择器引擎应该具有以下属性：

• query 函数：用于查询与根元素相对的第一个匹配选择器的元素。
• queryAll 函数：用于查询与根元素相对的所有匹配选择器的元素。

默认情况下，引擎直接在框架的 JavaScript 上下文中运行，并且可以调用应用程序定义的函数。为了将引擎与框架中的任何 JavaScript 隔离开来，但仍保留对 DOM 的访问权限，可以使用 {contentScript: true} 选项注册引擎。内容脚本引擎更加安全，因为它受到全局对象的保护，不会被篡改，例如修改 Node.prototype 方法。所有内置的选择器引擎都作为内容脚本运行。请注意，当引擎与其他自定义引擎一起使用时，不保证将其作为内容脚本运行。

必须在创建页面之前注册选择器。

注册一个基于标签名查询元素的选择器引擎的示例：

tag_selector = """  
    // 必须评估为选择器引擎实例。  
    {  
      // 返回在根元素的子树中第一个匹配给定选择器的元素。  
      query(root, selector) {  
        return root.querySelector(selector);  
      },  
  
      // 返回在根元素的子树中所有匹配给定选择器的元素。  
      queryAll(root, selector) {  
        return Array.from(root.querySelectorAll(selector));  
      }  
    }"""  
  
// 注册引擎。选择器将以 "tag=" 为前缀。  
playwright.selectors.register("tag", tag_selector);  
  
// 现在我们可以使用 "tag=" 选择器了。  
button = page.locator("tag=button");  
button.click();  
  
// 我们可以将其与内置定位器结合使用。  
page.locator("tag=div").get_by_text("click me").click();  
  
// 我们可以在任何支持选择器的方法中使用它。  
button_count = page.locator("tag=button").count();

在这个示例中，我们定义了一个名为 tag_selector 的选择器引擎，它使用 JavaScript 对象字面量语法。这个引擎包含两个方法：query 和 queryAll，分别用于查询第一个和所有匹配给定选择器的元素。然后，我们使用 playwright.selectors.register 方法将这个引擎注册为 "tag" 选择器，并指定选择器字符串将以 "tag=" 为前缀。

注册后，我们就可以在 Playwright 的页面定位器（page.locator）中使用 "tag=" 前缀来指定基于标签名的选择器了。例如，我们可以定位一个按钮并点击它，或者结合使用内置定位器来查找包含特定文本的 div 元素并点击它。此外，我们还可以使用支持选择器的任何方法来获取匹配元素的数量等信息。