node package manager


Web Push Testing Service

Travis Build Status NPM Dependency State NPM Dev Dependency State


Testing web push is hard and with difference between browsers being an issue as standards are created and implemented, the best approach to ensure a library is up to date is to have integration tests. Sadly this involves knowledge and implementation of selenium web driver and implementing the logic to manage those browsers for push testing.

This library handles the selenium and browser orchestrating and makes them available via a JSON API, simplifying the whole process.


npm install web-push-testing-service -g


To start the push testing service run:

web-push-testing-service start <Service Name>

This will start the service and run it in the background on port 8090. If you need to run it on a different port, you can use the port flag:

web-push-testing-service start <Service Name> -p 9000

Once you've finished using the service you just need run the stop command.

web-push-testing-service start <Service Name>

With the service started you can make POST requests in the following flow to write integration tests for your push library.

Regardless of the API you call, you'll receive JSON and the top level parameter will be either 'data' or 'error'. Data will change depending on the API called and error with have an 'id' and 'message' parameter.

  1. Start Test Suite This assigns a test suite ID to the current run that all future tests are tied to.


    Input: Nothing Output: Output: {data: {testSuiteId: }}

  2. Get a Subscription This method expected a testSuiteId, a browser name and the release version and it will return a subscription.

    The gcmSenderId and vapidPublicKey parameters are options BUT Chrome requires one of them to work, otherwise you must catch the error.


    Input: { testSuiteId: , browserName: <'chrome' | 'firefox'>, browserVersion: <'stable' | 'beta' | 'unstable' >, gcmSenderId: , vapidPublicKey: } Output: { data: { testId: , subscription: <A Subscription Object, will have endpoint and keys> } }

  3. Wait for notification to arrive Once your library has sent a message you can retrieve what details the browser received.


    Input: { testSuiteId: testId: }

    Output: { data: { messages: [ , ... ] } }

  4. End the Test Suite This will end and close any currently open tests.


    Input: {testSuiteId: } Output: {data: {success: true}}