authenticator-browser-extension

Authenticator (Browser Extension)

Authenticator is a web browser extension that enables your browser-based automated tests to authenticate with web apps using HTTP authentication.

Authenticator generates the browser extension dynamically, so you can easily provide the username and password via a config file or env variables.

Authenticator currently supports:

• Google Chrome

Usage

The best place to look for usage examples is the e2e test suite.

Protractor

Import the authenticator-browser-extension in the protractor.conf.js file:

// protractor.conf.js

const { Authenticator } = require('authenticator-browser-extension');

exports.config = {
    // protractor config
}

Chrome

Add the Authenticator to the list of Chrome extensions:

// protractor.conf.js

exports.config = {

    capabilities: {
        browserName: 'chrome',

        chromeOptions: {
            extensions: [
                Authenticator.for('username', 'password').asBase64()
            ]
        }
    },
}

Known limitations

Chrome headless

Chrome running in headless mode doesn't support browser extensions. Chrome developers have decided against implementing this feature in any near future due to complexity of the task.

The best way to get around this limitation is to use Chrome together with the X Virtual Framebuffer (XVFB).

Your feedback matters!

Do you find Authenticator useful? Give it a star! ★

Found a bug? Need a feature? Raise an issue or submit a pull request.

Have feedback? Let me know on twitter: @JanMolak

License

Authenticator library is licensed under the Apache-2.0 license.

- Copyright © 2019- Jan Molak