A robust & optimized polyfill for the String.prototype.includes method (previously known as String.prototype.contains) in ECMAScript 6.

This package implements the es-shim API interface. It works in an ES3-supported environment and complies with the spec.

Other polyfills for String.prototype.includes are available:

• https://github.com/paulmillr/es6-shim/blob/d8c4ec246a15e7df55da60b7f9b745af84ca9021/es6-shim.js#L186-L190 by Paul Miller (fails some tests passes all tests)
• https://github.com/google/traceur-compiler/blob/315bdad05d41de46d25337422d66686d63100d7a/src/runtime/polyfills/String.js#L68-L86 by Google (fails a lot of tests now uses this polyfill and passes all tests)

Via npm:

npm install string.prototype.includes

Then, in Node.js:

var includes = require('string.prototype.includes');

In a browser:

<script src="https://bundle.run/string.prototype.includes"></script>

NOTE: It's recommended that you install this module using a package manager such as npm, because loading multiple polyfills from a CDN (such as bundle.run) will lead to duplicated code.

Polyfills + test suites for String.prototype.startsWith and String.prototype.endsWith are available, too.

Mathias Bynens

This polyfill is available under the MIT license.