如何在C#版Playwright中添加自定义选择器简化元素定位

完全可以实现你需要的简化写法，以下是两种可落地的实现方案：

方案1：封装C#扩展方法（优先推荐） #

这种方式无需修改Playwright核心逻辑，代码侵入性极低，完全匹配你要求的$前缀调用语法：

第一步：编写扩展方法 #

using Microsoft.Playwright;

public static class PageExtensions
{
    // 扩展FillAsync方法，支持$前缀定位
    public static Task FillAsync(this IPage page, string selector, string value, bool? force = null, bool? noWaitAfter = null, float? timeout = null)
    {
        string processedSelector = selector;
        if (selector.StartsWith("$"))
        {
            // 替换$前缀为自定义属性选择器
            processedSelector = $"[data-automation-name={selector.TrimStart('$')}]";
        }
        return page.FillAsync(processedSelector, value, force, noWaitAfter, timeout);
    }

    // 可按照相同逻辑扩展其他常用方法，例如点击
    public static Task ClickAsync(this IPage page, string selector, bool? force = null, bool? noWaitAfter = null, float? timeout = null)
    {
        string processedSelector = selector;
        if (selector.StartsWith("$"))
        {
            processedSelector = $"[data-automation-name={selector.TrimStart('$')}]";
        }
        return page.ClickAsync(processedSelector, force, noWaitAfter, timeout);
    }
}

第二步：直接使用你期望的语法调用 #

// 无需额外配置，直接按照你期望的写法调用即可
page.FillAsync("$SOMENAME1", "1");
page.FillAsync("$SOMENAME2", "2");
page.FillAsync("$SOMENAME3", "3");
page.ClickAsync("$SubmitBtn");

方案2：注册全局自定义选择器引擎 #

Playwright本身支持全局注册自定义选择器引擎，注册一次所有场景生效，适合跨项目统一规范的场景：

// 在初始化Playwright实例后注册自定义选择器
var playwright = await Playwright.CreateAsync();
await playwright.Selectors.RegisterAsync("data-auto", new()
{
    // 定义查询逻辑
    Query = @"async (name, root) => root.querySelector(`[data-automation-name=""${name}""]`)",
    QueryAll = @"async (name, root) => Array.from(root.querySelectorAll(`[data-automation-name=""${name}""]`))"
});

使用方式：

// 语法为 引擎名=属性值
page.FillAsync("data-auto=SOMENAME1", "1");
page.ClickAsync("data-auto=SubmitBtn");

两种方案对比 #

• 扩展方法方案：完全匹配你需要的$前缀写法，无需写JS逻辑，可按需扩展不同操作方法，更适配当前需求
• 全局选择器引擎方案：官方原生支持，跨语言通用，全局生效，不需要为每个操作方法单独封装

内容的提问来源于stack exchange，提问作者Julian