Client-side based URL availability testing tool. For a full description of the project, see Visualising the censorship blog post.
How to use it
dist/assets/probe.statis.js - compiled probe file, to be injected into client pages
Include the file on your pages, and send out the reports using the following snippet:
targetsis the array of domain targets (URLs) to check,
expected_answeris the correct answer that should be received when polling those URLs,
cooldown_daysis the number of days to wait until repeating the check for this client,
report_successis whether to report successful checks, or failures only.
yourname.firebaseio.com should be changes to the name of your Firebase project that will host the report and processed data.
Processing reported data
bin/processor.js - summary statistics generator
bin/export.js - export processed and summarised report data
bin/locations.js - export location geo coordinates
Once some samples have been collected by the client-side probe, the standard workflow is:
- Post-process collected data:
- Export a csv file with the summarised results:
./bin/export.js > domain-availability.csv
- Export a csv file with the location geo coordinates:
./bin/locations.js > locations.csv
- Reload data files in Tableau to rebuild the visualisation.