Logo

A unified shared library which aids in building fuzzers for browsers or as complement for an already existing fuzzing framework.

JavaScript Style Guide Build Status Current Release Coverage Status IRC

Octo.js bundles core functions and generic boilerplate code commonly used in most frameworks for fuzzing browsers. It is designed for the sharing of improvements between our individual fuzzers, and with the purpose of reducing the maintainability of those core features with minimal effort. Octo's future aims to be a stable, well-tested and well-documented standard library for fuzzing in a JavaScript environment. # NOTE The ES6 branch is under active development while we are incorporating it into our existing fuzzers. This branch is current not maintained. ## Usage ```html https://mozillasecurity.github.io/octo/octo.js ``` ```html https://github.com/mozillasecurity/octo/releases/download/0.0.3/octo.js ``` ```html https://cdn.jsdelivr.net/gh/MozillaSecurity/octo@0.0.3/deploy/octo.js ``` ## Development ```bash npm install npm run build ``` ## Testing Tests live in the `tests/` subdirectory, and are written for [QUnit](https://qunitjs.com/). To run tests locally, open `tests/index.html` in a browser. The automated tests are run in Firefox or Chrome using [Karma](https://karma-runner.github.io/). To run the automated tests: ```bash npm install CHROME_BIN=chromium npm test ``` When adding new files, add them in `index.html` and `karma.conf.js` so they can be tested and included in coverage reports.