"If your website invokes a native dialog on startup" documentation doesn't work for local tests

[DanKaplanSES]

What is your Scenario?

I'm writing this as a bug because the documentation is incorrect. This page says:

If your website invokes a native dialog on startup, start the test from a different page (for example: about:blank). Initialize a handler and use the t.navigateTo method to open your website.

Important
Use an absolute path/URL to navigate away from the about:blank page.

Starting at an absolute file path won't work if you are testing locally because you will get an error when attempt to navigate away from about:blank:

What is the Current behavior?

hammerhead.js:43848 Not allowed to load local resource:

I'm using testcafe-hammerhead version 31.7.5.

What is the Expected behavior?

Rewrite the "Use an absolute path/URL to navigate away from the about:blank page" documentation to be unambiguous. Here are some examples:

1. Use an absolute URL path to navigate away from the about:blank page
2. Use an absolute URL with a URL protocol to navigate away from the about:blank page

What is the public URL of the test page? (attach your complete example)

about:blank

What is your TestCafe test code?

import { resolve } from 'path';
...
  await t.setNativeDialogHandler((type, text) => {
    throw new Error(text);
  });
  await t
    .navigateTo(`file:///` + resolve(`dist/index.html`))

Your complete configuration file

{
  "browsers": ["chrome"],
  "reporter": {
    "name": "spec-time"
  },
  "screenshots": {
    "takeOnFails": true,
    "fullPage": true
  },
  "concurrency": 1,
  "clientScripts": [
    {
      "path": "testcafe-client-scripts/jquery-3.7.1.min.js"
    },
    {
      "path": "testcafe-client-scripts/scriptContent.js"
    }
  ]
}

Your complete test report

No response

Screenshots

No response

Steps to Reproduce

n/a

TestCafe version

3.7.1

Node.js version

v22.13.0

Command-line arguments

testcafe 'end-to-end-tests/**.test.js'

Browser name(s) and version(s)

Chrome

Platform(s) and version(s)

Windows 10

Other

No response

[Bayheck]

Hello,

I did not manage to reproduce the described behavior.

Could you please create a reproducible minimal example?

[github-actions]

This issue was automatically closed because there was no response to our request for more information from the original author. Currently, we don't have enough information to take action. Please reach out to us if you find the necessary information and are able to share it. We are also eager to know if you resolved the issue on your own and can share your findings with everyone.