This site uses cookies for analytics. By continuing to browse this site, you agree to this use.
A JS Foundation Project


Chrome (@hint/connector-chrome)

A connector to use Google Chrome via the chrome debugging protocol in webhint.


First, you need to install webhint:

npm install hint

Then, install the new connector:

npm install @hint/connector-chrome


Configure the connector name in your .hintrc configuration file:

    "connector": {
        "name": "chrome"


The set of settings supported by Chrome connector are:

  • defaultProfile (boolean): Indicates if the browser should use the default profile or create a new one. By default the value is false so a new one is created. You might want to set it to true if you want webhint to have access to pages where the default profile is already authenticated. NOTE: Due to an issue in chrome-launcher, all the instances of the browser need to be closed before run webhint.
  • useTabUrl (boolean): Indicates if the browser should navigate first to a given page before going to the final target. false by default.
  • tabUrl (string): The URL to visit before the final target in case useTabUrl is true. is the default value.
  • flags? (string[]): Allows you to pass in additional Chrome command line API flags. Useful if you would like to start your session in headless mode or with GPU disabled. Here’s the full list of available command line flags. ['--no-default-browser-check'] is the default value.
  • waitForContentLoaded (number): Time in milliseconds to wait for the loadingFinished event from the debugging protocol before requesting the body of a response. The default value is 10000 (10 seconds).
    "connector": {
        "name": "chrome",
        "options": {
            "defaultProfile": true,
            "useTabUrl": false,
            "tabUrl": "",
            "flags": ["--headless", "--disable-gpu"],
            "waitForContentLoaded": 10000

Further Reading