Add comment

packages/playwright/src/matchers/expect.ts

@@ -285,6 +285,8 @@ class ExpectMetaInfoProxyHandler implements ProxyHandler<any> {
 
       try {
         const callback = () => matcher.call(target, ...args);
+        // toPass and poll matchers can contain other steps, expects and API calls,
+        // so they behave like a retriable step.
         const result = (matcherName === 'toPass' || this._info.isPoll) ?
           zones.run('stepZone', step, callback) :
           zones.run<ExpectZone, any>('expectZone', { title, wallTime }, callback);