Mocha异步钩子未运行？page始终为undefined问题求助

我一眼就发现了几个关键问题，咱们一步步拆解解决：

1. 内层describe的回调不能是async函数 #

Mocha的describe是用来同步定义测试套件结构的，它的回调函数不需要（也绝对不能）是异步的。如果你给describe加了async，Mocha不会等待这个回调返回的Promise，这会直接导致内部的钩子（比如你的内层before）注册时机异常，甚至完全不被执行。

2. 内层套件缺少测试用例（it块） #

Mocha只会执行包含测试用例（it）的套件里的钩子。如果你的内层describe里只有before但没有任何实际测试用例，这个before钩子根本不会被触发——这就是你打印page得到undefined的核心原因。

修改后的可运行代码 #

const should = require('chai').should()
const puppeteer = require('puppeteer')
const puppeteerConfig = { 
  headless: true, 
  args: ['--no-sandbox', '--disable-translate', '--disable-extensions', '--disable-sync'] 
}
let browser 
let page // 用let代替var，避免变量提升带来的意外作用域问题

describe('顶层测试套件', function() {
  // 给启动浏览器的操作设置足够超时（默认2000ms可能不够）
  this.timeout(10000)

  before(async function() {
    browser = await puppeteer.launch(puppeteerConfig)
  })

  after(async function() {
    await browser.close()
  })

  beforeEach(async function() {
    page = await browser.newPage()
    console.log('beforeEach: page实例已创建') // 加日志验证钩子执行情况
  })

  afterEach(async function() {
    await page.close()
  })

  // 移除内层describe的async修饰符
  describe('内层测试套件', function() {
    before(async function() {
      console.log('内层before钩子执行: ', page) // 现在能正常拿到page实例了
    })

    // 必须添加至少一个it测试用例，否则内层钩子不会被触发
    it('示例测试：访问example.com', async function() {
      await page.goto('https://example.com')
      const pageTitle = await page.title()
      pageTitle.should.equal('Example Domain')
    })
  })
})

额外优化建议 #

• 给顶层套件设置超时：启动Puppeteer浏览器的操作耗时可能超过Mocha默认的2000ms，设置this.timeout(10000)能避免不必要的超时错误。
• 用let替代var：var的变量提升特性容易引发作用域问题，let的块级作用域更清晰安全。
• 添加日志验证：在各个钩子中加入日志，可以直观确认before→beforeEach→内层before→it→afterEach→after的执行顺序是否符合预期。

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