https://github.com/guidesmiths/adblock-plus-crx

Adblock-Plus crx base64 encoded binary for chromedriver
https://github.com/guidesmiths/adblock-plus-crx

hacktoberfest

Last synced: 2 months ago
JSON representation

Adblock-Plus crx base64 encoded binary for chromedriver

• Host: GitHub
• URL: https://github.com/guidesmiths/adblock-plus-crx
• Owner: guidesmiths
• License: gpl-3.0
• Created: 2016-04-21T21:24:55.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-10-26T20:00:15.000Z (about 3 years ago)
• Last Synced: 2024-08-11T09:55:04.385Z (5 months ago)
• Topics: hacktoberfest
• Language: JavaScript
• Size: 1.02 MB
• Stars: 11
• Watchers: 13
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Adblock-Plus.crx

Adverts can slow and even break functional tests. If you run your functional tests using ChromeDriver you can install extensions like AdBlock-Plus as follows...

```

{

  ...

  "desiredCapabilities": {

    "javascriptEnabled": true,

    "acceptSslCerts": true,

    "browserName": "chrome",

    "chromeOptions": {

      "args": [ "no-sandbox" ],

      "extensions": [ "Q3Iy....AAAA=" ]

    }

  }

  ...

}

```

Where ```Q3Iy....AAAA=``` is the base64 encoded crx file you want to install. Unfortunately Adblock-Plus is around 600KB when encoded and not something you really want to include in a json file.

When using the excellent [Nightwatch.js](http://nightwatchjs.org/) you can define configuration in ```nightwatch.conf.js``` instead of json.

```

var adBlockPlus = require('adblock-plus-crx')

module.exports = {

  ...

  "desiredCapabilities": {

    "javascriptEnabled": true,

    "acceptSslCerts": true,

    "browserName": "chrome",

    "chromeOptions": {

      "args": [ "no-sandbox" ],

      "extensions": [ adBlockPlus.base64() ]

    }

  }

  ...

}

```

# Modifications

AdBlock-Plus opens a new tab on first run and since WebDriver tests typically start with a fresh profile each run gets more than a little annoying.  We've disabled first run behaviour by setting ```suppress_first_run_page``` to true and recreating the crx.

# Using a custom crx (instructions for OSX)

1. Fork this project

1. Rename the package

1. Update the adblock-plus-crx version in package.json

1. Add modifications to ```./scripts/update.sh```

1. Run ```./scripts/update.sh``` from forks root directory - i.e. the one containing package.json

1. Commit your changes and publish to npm or a private repo.

# Pull Requests

If you don't want to publish an alternative version of this package, I will consider pull requests for adblock-plus version updates and generally useful modifications, however the later should be done by amending ```./scripts/update.sh```. I cannot accept changes to the crx file itself.