/**
 * Copyright 2018 Google Inc. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

import type {ServerResponse} from 'http';

import expect from 'expect';
import {type Frame, TimeoutError} from 'puppeteer';
import type {HTTPRequest} from 'puppeteer-core/internal/api/HTTPRequest.js';
import type {HTTPResponse} from 'puppeteer-core/internal/api/HTTPResponse.js';
import {Deferred} from 'puppeteer-core/internal/util/Deferred.js';

import {getTestState, setupTestBrowserHooks} from './mocha-utils.js';
import {attachFrame, isFavicon, waitEvent} from './utils.js';

describe('navigation', function () {
  setupTestBrowserHooks();

  describe('Page.goto', function () {
    it('should work', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      expect(page.url()).toBe(server.EMPTY_PAGE);
    });
    it('should work with anchor navigation', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      expect(page.url()).toBe(server.EMPTY_PAGE);
      await page.goto(server.EMPTY_PAGE + '#foo');
      expect(page.url()).toBe(server.EMPTY_PAGE + '#foo');
      await page.goto(server.EMPTY_PAGE + '#bar');
      expect(page.url()).toBe(server.EMPTY_PAGE + '#bar');
    });
    it('should work with redirects', async () => {
      const {page, server} = await getTestState();

      server.setRedirect('/redirect/1.html', '/redirect/2.html');
      server.setRedirect('/redirect/2.html', '/empty.html');
      await page.goto(server.PREFIX + '/redirect/1.html');
      expect(page.url()).toBe(server.EMPTY_PAGE);
    });
    it('should navigate to about:blank', async () => {
      const {page} = await getTestState();

      const response = await page.goto('about:blank');
      expect(response).toBe(null);
    });
    it('should return response when page changes its URL after load', async () => {
      const {page, server} = await getTestState();

      const response = await page.goto(server.PREFIX + '/historyapi.html');
      expect(response!.status()).toBe(200);
    });
    it('should work with subframes return 204', async () => {
      const {page, server} = await getTestState();

      server.setRoute('/frames/frame.html', (_req, res) => {
        res.statusCode = 204;
        res.end();
      });
      let error!: Error;
      await page
        .goto(server.PREFIX + '/frames/one-frame.html')
        .catch(error_ => {
          return (error = error_);
        });
      expect(error).toBeUndefined();
    });
    it('should fail when server returns 204', async () => {
      const {page, server, isChrome} = await getTestState();

      server.setRoute('/empty.html', (_req, res) => {
        res.statusCode = 204;
        res.end();
      });
      let error!: Error;
      await page.goto(server.EMPTY_PAGE).catch(error_ => {
        return (error = error_);
      });
      expect(error).not.toBe(null);
      if (isChrome) {
        expect(error.message).toContain('net::ERR_ABORTED');
      } else {
        expect(error.message).toContain('NS_BINDING_ABORTED');
      }
    });
    it('should navigate to empty page with domcontentloaded', async () => {
      const {page, server} = await getTestState();

      const response = await page.goto(server.EMPTY_PAGE, {
        waitUntil: 'domcontentloaded',
      });
      expect(response!.status()).toBe(200);
    });
    it('should work when page calls history API in beforeunload', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.evaluate(() => {
        window.addEventListener(
          'beforeunload',
          () => {
            return history.replaceState(null, 'initial', window.location.href);
          },
          false
        );
      });
      const response = await page.goto(server.PREFIX + '/grid.html');
      expect(response!.status()).toBe(200);
    });
    it('should navigate to empty page with networkidle0', async () => {
      const {page, server} = await getTestState();

      const response = await page.goto(server.EMPTY_PAGE, {
        waitUntil: 'networkidle0',
      });
      expect(response!.status()).toBe(200);
    });
    it('should navigate to page with iframe and networkidle0', async () => {
      const {page, server} = await getTestState();

      const response = await page.goto(
        server.PREFIX + '/frames/one-frame.html',
        {
          waitUntil: 'networkidle0',
        }
      );
      expect(response!.status()).toBe(200);
    });
    it('should navigate to empty page with networkidle2', async () => {
      const {page, server} = await getTestState();

      const response = await page.goto(server.EMPTY_PAGE, {
        waitUntil: 'networkidle2',
      });
      expect(response!.status()).toBe(200);
    });
    it('should fail when navigating to bad url', async () => {
      const {page} = await getTestState();

      let error!: Error;
      await page.goto('asdfasdf').catch(error_ => {
        return (error = error_);
      });

      expect(error.message).atLeastOneToContain([
        'Cannot navigate to invalid URL', // Firefox WebDriver BiDi.
        'invalid argument', // Others.
      ]);
    });

    const EXPECTED_SSL_CERT_MESSAGE_REGEX =
      /net::ERR_CERT_INVALID|net::ERR_CERT_AUTHORITY_INVALID/;

    it('should fail when navigating to bad SSL', async () => {
      const {page, httpsServer, isChrome} = await getTestState();

      // Make sure that network events do not emit 'undefined'.
      // @see https://crbug.com/750469
      const requests: string[] = [];
      page.on('request', () => {
        return requests.push('request');
      });
      page.on('requestfinished', () => {
        return requests.push('requestfinished');
      });
      page.on('requestfailed', () => {
        return requests.push('requestfailed');
      });

      let error!: Error;
      await page.goto(httpsServer.EMPTY_PAGE).catch(error_ => {
        return (error = error_);
      });
      if (isChrome) {
        expect(error.message).toMatch(EXPECTED_SSL_CERT_MESSAGE_REGEX);
      } else {
        expect(error.message).toContain('SSL_ERROR_UNKNOWN');
      }

      expect(requests).toHaveLength(2);
      expect(requests[0]).toBe('request');
      expect(requests[1]).toBe('requestfailed');
    });
    it('should fail when navigating to bad SSL after redirects', async () => {
      const {page, server, httpsServer, isChrome} = await getTestState();

      server.setRedirect('/redirect/1.html', '/redirect/2.html');
      server.setRedirect('/redirect/2.html', '/empty.html');
      let error!: Error;
      await page.goto(httpsServer.PREFIX + '/redirect/1.html').catch(error_ => {
        return (error = error_);
      });
      if (isChrome) {
        expect(error.message).toMatch(EXPECTED_SSL_CERT_MESSAGE_REGEX);
      } else {
        expect(error.message).atLeastOneToContain([
          'MOZILLA_PKIX_ERROR_SELF_SIGNED_CERT', // Firefox WebDriver BiDi.
          'SSL_ERROR_UNKNOWN ', // Others.
        ]);
      }
    });
    it('should fail when main resources failed to load', async () => {
      const {page, isChrome} = await getTestState();

      let error!: Error;
      await page
        .goto('http://localhost:44123/non-existing-url')
        .catch(error_ => {
          return (error = error_);
        });
      if (isChrome) {
        expect(error.message).toContain('net::ERR_CONNECTION_REFUSED');
      } else {
        expect(error.message).toContain('NS_ERROR_CONNECTION_REFUSED');
      }
    });
    it('should fail when exceeding maximum navigation timeout', async () => {
      const {page, server} = await getTestState();

      // Hang for request to the empty.html
      server.setRoute('/empty.html', () => {});
      let error!: Error;
      await page
        .goto(server.PREFIX + '/empty.html', {timeout: 1})
        .catch(error_ => {
          return (error = error_);
        });
      expect(error.message).toContain('Navigation timeout of 1 ms exceeded');
      expect(error).toBeInstanceOf(TimeoutError);
    });
    it('should fail when exceeding default maximum navigation timeout', async () => {
      const {page, server} = await getTestState();

      // Hang for request to the empty.html
      server.setRoute('/empty.html', () => {});
      let error!: Error;
      page.setDefaultNavigationTimeout(1);
      await page.goto(server.PREFIX + '/empty.html').catch(error_ => {
        return (error = error_);
      });
      expect(error.message).toContain('Navigation timeout of 1 ms exceeded');
      expect(error).toBeInstanceOf(TimeoutError);
    });
    it('should fail when exceeding default maximum timeout', async () => {
      const {page, server} = await getTestState();

      // Hang for request to the empty.html
      server.setRoute('/empty.html', () => {});
      let error!: Error;
      page.setDefaultTimeout(1);
      await page.goto(server.PREFIX + '/empty.html').catch(error_ => {
        return (error = error_);
      });
      expect(error.message).toContain('Navigation timeout of 1 ms exceeded');
      expect(error).toBeInstanceOf(TimeoutError);
    });
    it('should prioritize default navigation timeout over default timeout', async () => {
      const {page, server} = await getTestState();

      // Hang for request to the empty.html
      server.setRoute('/empty.html', () => {});
      let error!: Error;
      page.setDefaultTimeout(0);
      page.setDefaultNavigationTimeout(1);
      await page.goto(server.PREFIX + '/empty.html').catch(error_ => {
        return (error = error_);
      });
      expect(error.message).toContain('Navigation timeout of 1 ms exceeded');
      expect(error).toBeInstanceOf(TimeoutError);
    });
    it('should disable timeout when its set to 0', async () => {
      const {page, server} = await getTestState();

      let error!: Error;
      let loaded = false;
      page.once('load', () => {
        loaded = true;
      });
      await page
        .goto(server.PREFIX + '/grid.html', {timeout: 0, waitUntil: ['load']})
        .catch(error_ => {
          return (error = error_);
        });
      expect(error).toBeUndefined();
      expect(loaded).toBe(true);
    });
    it('should work when navigating to valid url', async () => {
      const {page, server} = await getTestState();

      const response = (await page.goto(server.EMPTY_PAGE))!;
      expect(response.ok()).toBe(true);
    });
    it('should work when navigating to data url', async () => {
      const {page} = await getTestState();

      const response = (await page.goto('data:text/html,hello'))!;
      expect(response.ok()).toBe(true);
    });
    it('should work when navigating to 404', async () => {
      const {page, server} = await getTestState();

      const response = (await page.goto(server.PREFIX + '/not-found'))!;
      expect(response.ok()).toBe(false);
      expect(response.status()).toBe(404);
    });
    it('should not throw an error for a 404 response with an empty body', async () => {
      const {page, server} = await getTestState();

      server.setRoute('/404-error', (_, res) => {
        res.statusCode = 404;
        res.end();
      });

      const response = (await page.goto(server.PREFIX + '/404-error'))!;
      expect(response.ok()).toBe(false);
      expect(response.status()).toBe(404);
    });
    it('should not throw an error for a 500 response with an empty body', async () => {
      const {page, server} = await getTestState();

      server.setRoute('/500-error', (_, res) => {
        res.statusCode = 500;
        res.end();
      });

      const response = (await page.goto(server.PREFIX + '/500-error'))!;
      expect(response.ok()).toBe(false);
      expect(response.status()).toBe(500);
    });
    it('should return last response in redirect chain', async () => {
      const {page, server} = await getTestState();

      server.setRedirect('/redirect/1.html', '/redirect/2.html');
      server.setRedirect('/redirect/2.html', '/redirect/3.html');
      server.setRedirect('/redirect/3.html', server.EMPTY_PAGE);
      const response = (await page.goto(server.PREFIX + '/redirect/1.html'))!;
      expect(response.ok()).toBe(true);
      expect(response.url()).toBe(server.EMPTY_PAGE);
    });
    it('should wait for network idle to succeed navigation', async () => {
      const {page, server} = await getTestState();

      let responses: ServerResponse[] = [];
      // Hold on to a bunch of requests without answering.
      server.setRoute('/fetch-request-a.js', (_req, res) => {
        return responses.push(res);
      });
      server.setRoute('/fetch-request-b.js', (_req, res) => {
        return responses.push(res);
      });
      server.setRoute('/fetch-request-c.js', (_req, res) => {
        return responses.push(res);
      });
      server.setRoute('/fetch-request-d.js', (_req, res) => {
        return responses.push(res);
      });
      const initialFetchResourcesRequested = Promise.all([
        server.waitForRequest('/fetch-request-a.js'),
        server.waitForRequest('/fetch-request-b.js'),
        server.waitForRequest('/fetch-request-c.js'),
      ]).catch(() => {
        // Ignore Error that arise from test server during hooks
      });
      const secondFetchResourceRequested = server
        .waitForRequest('/fetch-request-d.js')
        .catch(() => {
          // Ignore Error that arise from test server during hooks
        });

      // Track when the navigation gets completed.
      let navigationFinished = false;
      let navigationError: Error | undefined;
      // Navigate to a page which loads immediately and then does a bunch of
      // requests via javascript's fetch method.
      const navigationPromise = page
        .goto(server.PREFIX + '/networkidle.html', {
          waitUntil: 'networkidle0',
        })
        .then(response => {
          navigationFinished = true;
          return response;
        })
        .catch(error => {
          navigationError = error;
          return null;
        });

      let afterNavigationError: Error | undefined;
      const afterNavigationPromise = (async () => {
        // Wait for the page's 'load' event.
        await waitEvent(page, 'load');
        expect(navigationFinished).toBe(false);

        // Wait for the initial three resources to be requested.
        await initialFetchResourcesRequested;

        // Expect navigation still to be not finished.
        expect(navigationFinished).toBe(false);

        // Respond to initial requests.
        for (const response of responses) {
          response.statusCode = 404;
          response.end(`File not found`);
        }

        // Reset responses array
        responses = [];

        // Wait for the second round to be requested.
        await secondFetchResourceRequested;
        // Expect navigation still to be not finished.
        expect(navigationFinished).toBe(false);

        // Respond to requests.
        for (const response of responses) {
          response.statusCode = 404;
          response.end(`File not found`);
        }
      })().catch(error => {
        afterNavigationError = error;
      });

      await Promise.race([navigationPromise, afterNavigationPromise]);
      if (navigationError) {
        throw navigationError;
      }
      await Promise.all([navigationPromise, afterNavigationPromise]);
      if (afterNavigationError) {
        throw afterNavigationError;
      }
      // Expect navigation to succeed.
      expect(navigationFinished).toBeTruthy();
      expect((await navigationPromise)?.ok()).toBe(true);
    });
    it('should not leak listeners during navigation', async function () {
      this.timeout(25_000);

      const {page, server} = await getTestState();

      let warning = null;
      const warningHandler: NodeJS.WarningListener = w => {
        return (warning = w);
      };
      process.on('warning', warningHandler);
      for (let i = 0; i < 20; ++i) {
        await page.goto(server.EMPTY_PAGE);
      }
      process.removeListener('warning', warningHandler);
      expect(warning).toBe(null);
    });
    it('should not leak listeners during bad navigation', async function () {
      this.timeout(25_000);

      const {page} = await getTestState();

      let warning = null;
      const warningHandler: NodeJS.WarningListener = w => {
        return (warning = w);
      };
      process.on('warning', warningHandler);
      for (let i = 0; i < 20; ++i) {
        await page.goto('asdf').catch(() => {
          /* swallow navigation error */
        });
      }
      process.removeListener('warning', warningHandler);
      expect(warning).toBe(null);
    });
    it('should not leak listeners during navigation of 11 pages', async function () {
      this.timeout(25_000);

      const {context, server} = await getTestState();

      let warning = null;
      const warningHandler: NodeJS.WarningListener = w => {
        return (warning = w);
      };
      process.on('warning', warningHandler);
      await Promise.all(
        [...Array(20)].map(async () => {
          const page = await context.newPage();
          await page.goto(server.EMPTY_PAGE);
          await page.close();
        })
      );
      process.removeListener('warning', warningHandler);
      expect(warning).toBe(null);
    });
    it('should navigate to dataURL and fire dataURL requests', async () => {
      const {page} = await getTestState();

      const requests: HTTPRequest[] = [];
      page.on('request', request => {
        return !isFavicon(request) && requests.push(request);
      });
      const dataURL = 'data:text/html,<div>yo</div>';
      const response = (await page.goto(dataURL))!;
      expect(response.status()).toBe(200);
      expect(requests).toHaveLength(1);
      expect(requests[0]!.url()).toBe(dataURL);
    });
    it('should navigate to URL with hash and fire requests without hash', async () => {
      const {page, server} = await getTestState();

      const requests: HTTPRequest[] = [];
      page.on('request', request => {
        return !isFavicon(request) && requests.push(request);
      });
      const response = (await page.goto(server.EMPTY_PAGE + '#hash'))!;
      expect(response.status()).toBe(200);
      expect(response.url()).toBe(server.EMPTY_PAGE);
      expect(requests).toHaveLength(1);
      expect(requests[0]!.url()).toBe(server.EMPTY_PAGE);
    });
    it('should work with self requesting page', async () => {
      const {page, server} = await getTestState();

      const response = (await page.goto(server.PREFIX + '/self-request.html'))!;
      expect(response.status()).toBe(200);
      expect(response.url()).toContain('self-request.html');
    });
    it('should fail when navigating and show the url at the error message', async () => {
      const {page, httpsServer} = await getTestState();

      const url = httpsServer.PREFIX + '/redirect/1.html';
      let error!: Error;
      try {
        await page.goto(url);
      } catch (error_) {
        error = error_ as Error;
      }
      expect(error.message).toContain(url);
    });
    it('should send referer', async () => {
      const {page, server} = await getTestState();

      const requests = Promise.all([
        server.waitForRequest('/grid.html'),
        server.waitForRequest('/digits/1.png'),
        page.goto(server.PREFIX + '/grid.html', {
          referer: 'http://google.com/',
        }),
      ]).catch(() => {
        return [];
      });

      const [request1, request2] = await requests;
      expect(request1.headers['referer']).toBe('http://google.com/');
      // Make sure subresources do not inherit referer.
      expect(request2.headers['referer']).toBe(server.PREFIX + '/grid.html');
    });

    it('should send referer policy', async () => {
      const {page, server} = await getTestState();

      const [request1, request2] = await Promise.all([
        server.waitForRequest('/grid.html'),
        server.waitForRequest('/digits/1.png'),
        page.goto(server.PREFIX + '/grid.html', {
          referrerPolicy: 'no-referer',
        }),
      ]).catch(() => {
        return [];
      });
      expect(request1.headers['referer']).toBeUndefined();
      expect(request2.headers['referer']).toBe(server.PREFIX + '/grid.html');
    });
  });

  describe('Page.waitForNavigation', function () {
    it('should work', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      const [response] = await Promise.all([
        page.waitForNavigation(),
        page.evaluate((url: string) => {
          return (window.location.href = url);
        }, server.PREFIX + '/grid.html'),
      ]);
      expect(response!.ok()).toBe(true);
      expect(response!.url()).toContain('grid.html');
    });
    it('should work with both domcontentloaded and load', async () => {
      const {page, server} = await getTestState();

      let response!: ServerResponse;
      server.setRoute('/one-style.css', (_req, res) => {
        return (response = res);
      });
      let error: Error | undefined;
      let bothFired = false;
      const navigationPromise = page
        .goto(server.PREFIX + '/one-style.html')
        .catch(_error => {
          return (error = _error);
        });
      const domContentLoadedPromise = page
        .waitForNavigation({
          waitUntil: 'domcontentloaded',
        })
        .catch(_error => {
          return (error = _error);
        });

      const loadFiredPromise = page
        .waitForNavigation({
          waitUntil: 'load',
        })
        .then(() => {
          return (bothFired = true);
        })
        .catch(_error => {
          return (error = _error);
        });

      await server.waitForRequest('/one-style.css').catch(() => {});
      await domContentLoadedPromise;
      expect(bothFired).toBe(false);
      response.end();
      await loadFiredPromise;
      await navigationPromise;
      expect(error).toBeUndefined();
    });
    it('should work with clicking on anchor links', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.setContent(`<a href='#foobar'>foobar</a>`);
      const [response] = await Promise.all([
        page.waitForNavigation(),
        page.click('a'),
      ]);
      expect(response).toBe(null);
      expect(page.url()).toBe(server.EMPTY_PAGE + '#foobar');
    });
    it('should work with history.pushState()', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.setContent(`
        <a onclick='javascript:pushState()'>SPA</a>
        <script>
          function pushState() { history.pushState({}, '', 'wow.html') }
        </script>
      `);
      const [response] = await Promise.all([
        page.waitForNavigation(),
        page.click('a'),
      ]);
      expect(response).toBe(null);
      expect(page.url()).toBe(server.PREFIX + '/wow.html');
    });
    it('should work with history.replaceState()', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.setContent(`
        <a onclick='javascript:replaceState()'>SPA</a>
        <script>
          function replaceState() { history.replaceState({}, '', '/replaced.html') }
        </script>
      `);
      const [response] = await Promise.all([
        page.waitForNavigation(),
        page.click('a'),
      ]);
      expect(response).toBe(null);
      expect(page.url()).toBe(server.PREFIX + '/replaced.html');
    });
    it('should work with DOM history.back()/history.forward()', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.setContent(`
        <a id=back onclick='javascript:goBack()'>back</a>
        <a id=forward onclick='javascript:goForward()'>forward</a>
        <script>
          function goBack() { history.back(); }
          function goForward() { history.forward(); }
          history.pushState({}, '', '/first.html');
          history.pushState({}, '', '/second.html');
        </script>
      `);
      expect(page.url()).toBe(server.PREFIX + '/second.html');
      const [backResponse] = await Promise.all([
        page.waitForNavigation(),
        page.click('a#back'),
      ]);
      expect(backResponse).toBe(null);
      expect(page.url()).toBe(server.PREFIX + '/first.html');
      const [forwardResponse] = await Promise.all([
        page.waitForNavigation(),
        page.click('a#forward'),
      ]);
      expect(forwardResponse).toBe(null);
      expect(page.url()).toBe(server.PREFIX + '/second.html');
    });
    it('should work when subframe issues window.stop()', async function () {
      const {page, server} = await getTestState();

      server.setRoute('/frames/style.css', () => {});
      let frame: Frame | undefined;
      const eventPromises = Deferred.race([
        Promise.all([
          waitEvent(page, 'frameattached').then(_frame => {
            return (frame = _frame);
          }),
          waitEvent(page, 'framenavigated', f => {
            return f === frame;
          }),
        ]),
        Deferred.create({
          message: `should work when subframe issues window.stop()`,
          timeout: this.timeout() - 1000,
        }),
      ]);
      const navigationPromise = page.goto(
        server.PREFIX + '/frames/one-frame.html'
      );
      try {
        await eventPromises;
      } catch (error) {
        navigationPromise.catch(() => {});
        throw error;
      }
      await Promise.all([
        frame!.evaluate(() => {
          return window.stop();
        }),
        navigationPromise,
      ]);
    });
  });

  describe('Page.goBack', function () {
    it('should work', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.goto(server.PREFIX + '/grid.html');

      let response = (await page.goBack())!;
      expect(response.ok()).toBe(true);
      expect(response.url()).toContain(server.EMPTY_PAGE);

      response = (await page.goForward())!;
      expect(response.ok()).toBe(true);
      expect(response.url()).toContain('/grid.html');

      response = (await page.goForward())!;
      expect(response).toBe(null);
    });
    it('should work with HistoryAPI', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.evaluate(() => {
        history.pushState({}, '', '/first.html');
        history.pushState({}, '', '/second.html');
      });
      expect(page.url()).toBe(server.PREFIX + '/second.html');

      await page.goBack();
      expect(page.url()).toBe(server.PREFIX + '/first.html');
      await page.goBack();
      expect(page.url()).toBe(server.EMPTY_PAGE);
      await page.goForward();
      expect(page.url()).toBe(server.PREFIX + '/first.html');
    });
  });

  describe('Frame.goto', function () {
    it('should navigate subframes', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.PREFIX + '/frames/one-frame.html');
      expect(page.frames()[0]!.url()).toContain('/frames/one-frame.html');
      expect(page.frames()[1]!.url()).toContain('/frames/frame.html');

      const response = (await page.frames()[1]!.goto(server.EMPTY_PAGE))!;
      expect(response.ok()).toBe(true);
      expect(response.frame()).toBe(page.frames()[1]);
    });
    it('should reject when frame detaches', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.PREFIX + '/frames/one-frame.html');

      server.setRoute('/empty.html', () => {});
      const navigationPromise = page
        .frames()[1]!
        .goto(server.EMPTY_PAGE)
        .catch(error_ => {
          return error_;
        });
      await server.waitForRequest('/empty.html').catch(() => {});

      await page.$eval('iframe', frame => {
        return frame.remove();
      });
      const error = await navigationPromise;
      expect(error.message).atLeastOneToContain([
        'Navigating frame was detached',
        'Error: NS_BINDING_ABORTED',
        'net::ERR_ABORTED',
      ]);
    });
    it('should return matching responses', async () => {
      const {page, server} = await getTestState();

      // Disable cache: otherwise, the browser will cache similar requests.
      await page.setCacheEnabled(false);
      await page.goto(server.EMPTY_PAGE);
      // Attach three frames.
      const frames = await Promise.all([
        attachFrame(page, 'frame1', server.EMPTY_PAGE),
        attachFrame(page, 'frame2', server.EMPTY_PAGE),
        attachFrame(page, 'frame3', server.EMPTY_PAGE),
      ]);
      // Navigate all frames to the same URL.
      const serverResponses: ServerResponse[] = [];
      server.setRoute('/one-style.html', (_req, res) => {
        return serverResponses.push(res);
      });
      const navigations: Array<Promise<HTTPResponse | null>> = [];
      for (let i = 0; i < 3; ++i) {
        navigations.push(frames[i]!.goto(server.PREFIX + '/one-style.html'));
        await server.waitForRequest('/one-style.html');
      }
      // Respond from server out-of-order.
      const serverResponseTexts = ['AAA', 'BBB', 'CCC'];
      try {
        for (const i of [1, 2, 0]) {
          const response = await getResponse(i);
          expect(response.frame()).toBe(frames[i]);
          expect(await response.text()).toBe(serverResponseTexts[i]);
        }
      } catch (error) {
        await Promise.all([getResponse(0), getResponse(1), getResponse(2)]);
        throw error;
      }

      async function getResponse(index: number) {
        serverResponses[index]!.end(serverResponseTexts[index]);
        return (await navigations[index])!;
      }
    });
  });

  describe('Frame.waitForNavigation', function () {
    it('should work', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.PREFIX + '/frames/one-frame.html');
      const frame = page.frames()[1]!;
      const [response] = await Promise.all([
        frame.waitForNavigation(),
        frame.evaluate((url: string) => {
          return (window.location.href = url);
        }, server.PREFIX + '/grid.html'),
      ]);
      expect(response!.ok()).toBe(true);
      expect(response!.url()).toContain('grid.html');
      expect(response!.frame()).toBe(frame);
      expect(page.url()).toContain('/frames/one-frame.html');
    });
    it('should fail when frame detaches', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.PREFIX + '/frames/one-frame.html');
      const frame = page.frames()[1]!;

      server.setRoute('/empty.html', () => {});
      let error!: Error;
      const navigationPromise = frame.waitForNavigation().catch(error_ => {
        return (error = error_);
      });
      await Promise.all([
        server.waitForRequest('/empty.html'),
        frame.evaluate(() => {
          return ((window as any).location = '/empty.html');
        }),
      ]);
      await page.$eval('iframe', frame => {
        return frame.remove();
      });
      await navigationPromise;
      expect(error.message).atLeastOneToContain([
        'Navigating frame was detached',
        'Frame detached',
      ]);
    });
  });

  describe('Page.reload', function () {
    it('should work', async () => {
      const {page, server} = await getTestState();

      await page.goto(server.EMPTY_PAGE);
      await page.evaluate(() => {
        return ((globalThis as any)._foo = 10);
      });
      await page.reload();
      expect(
        await page.evaluate(() => {
          return (globalThis as any)._foo;
        })
      ).toBe(undefined);
    });
  });
});
