Tiny, forgiving HTML parser

Downloads in past


171001.1.37 years ago8 years agoMinified + gzip package size for prescribe in KB


Version License Build Status Code Climate Coverage Dependencies Commitizen friendly semantic-release Gitter
Tiny, forgiving HTML parser in JavaScript. This module started life as code from John Resig and has evolved and morphed over the years of hardening and use in Krux's postscribe library. This library doesn't aim for the greatest level of compliance, but rather to be as forgiving of real-life code encountered in scenarios like ad serving.



If you just want to use the script without installing anything:
<script src="dist/prescribe.min.js"></script>


You can include prescribe using npm:
npm install --save prescribe

This script runs in browsers, so this assumes you're using a module bundler like webpack, Browserify, JSPM or Rollup to consume CommonJS modules.



import HtmlParser from 'prescribe';


define(['prescribe'], function(HtmlParser) {



var HtmlParser = require('prescribe');
Browser Compatibility
This module is meant to parse any HTML that you can throw at it and do something meaningful, and we've taken care to make sur that it works on every browser we can get our hands on. We expect it to work on every browser built after 2009. There are over 30 unit tests that run on every commit. Prescribe is thoroughly tested and known to work well in the following browsers:
  • Firefox 4+
  • Chrome 10+
  • Safari 5.0+
  • Opera 10.0+
  • Internet Explorer 8+
  • iPhone/iPad and other WebKit-based browsers

Note that we do not provide any support for Internet Explorer versions earlier than IE8.
We ♥ bug reports.
Have a problem? Need help? Would you like additional functionality added? We use GitHub's ticket system for keeping track of these requests.
Please check out the existing issues, and if you don't see that your problem is already being worked on, please file a new issue. The more information the better to describe your problem.
We ♥ forks and pull requests.
Please see for full details.


The project requires nodejs (>=5.6) and npm (>=3.6.0) for development. It has no runtime dependencies.


Check the code out and install the development dependencies using:
npm install


To build the code, run
npm run build


We use ESLint and JSCS to do static analysis of the JavaScript and keep things smelling good. To run both, use:
npm run lint


Using travis-ci, the Mocha unit tests are run on every commit using PhantomJS to run the tests with a real browser.
To test the code locally, you can use:
npm test

To run tests in Test-Driven-Development mode, where the test will be run after every change, use:
npm run tdd

To run the cross-browser tests, use:
npm run test:cross-browser

Issue Guidelines

Please either add a failing unit test or include a jsfiddle that distills and reproduces the issue.
We aim for you to use this inside your application, so we picked the least restrictive license we could find: the MIT license.