如何在TypeScript/Playwright中避免链式异步方法的多层await？

核心方案：拆分await为顺序执行，优化页面方法设计 #

你的问题根源是把多个异步调用的结果链式嵌套await，其实完全可以拆成单独的await语句，让代码更清晰易读：

改造页面类的方法签名 #

确保每个页面方法都是异步方法，返回Task<当前页面类型/目标页面类型>，示例如下：

public class HomePage
{
    private readonly IPage _page;
    public HomePage(IPage page) => _page = page;

    public async Task<HomePage> Goto()
    {
        await _page.GotoAsync("/");
        return this;
    }

    public async Task<HomePage> DoSomething()
    {
        await _page.ClickAsync("#some-button");
        // 执行其他页面操作
        return this;
    }

    public async Task<NextPage> NavigateToNextPage()
    {
        await _page.ClickAsync("#next-page-link");
        return new NextPage(_page);
    }
}

public class NextPage
{
    private readonly IPage _page;
    public NextPage(IPage page) => _page = page;

    public async Task ValidateResult()
    {
        await _page.WaitForSelectorAsync(".result-success");
        // 执行断言逻辑
    }
}

编写测试时拆分await语句 #

改造后，测试代码可以写成顺序执行的await，完全避免嵌套：

var homePage = new HomePage(page);
await homePage.Goto();
await homePage.DoSomething();
var nextPage = await homePage.NavigateToNextPage();
await nextPage.ValidateResult();

关于异步测试的必要性 #

不用放弃异步，Playwright的API本身就是异步优先设计的——浏览器的DOM操作、网络请求都是异步行为，异步测试能更精准地匹配这些操作的时序，避免同步测试中常见的等待超时或不稳定问题。测试的顺序执行和异步并不冲突，异步只是让代码正确等待浏览器操作完成，你依然可以按测试逻辑的顺序编写步骤。

为什么Promise.all不适用 #

你的判断是对的，Promise.all（C#中对应Task.WhenAll）用于并行执行多个无依赖的任务，而你的测试步骤是强依赖的：必须等待页面跳转完成才能执行后续操作，必须完成当前页面操作才能跳转到下一页，这种链式依赖场景下，并行执行反而会导致错误。

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