string.prototype.matchall
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/string.prototype.matchall package

    3.0.1 • Public • Published

    string.prototype.matchall Version Badge

    Build Status dependency status dev dependency status License Downloads

    npm badge

    browser support

    ES Proposal spec-compliant shim for String.prototype.matchAll. Invoke its "shim" method to shim String.prototype.matchAll if it is unavailable or noncompliant.

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

    Most common usage:

    const assert = require('assert');
    const matchAll = require('string.prototype.matchall');
     
    const str = 'aabc';
    const nonRegexStr = 'ab';
    const globalRegex = /[ac]/g;
    const nonGlobalRegex = /[bc]/i;
     
    // non-regex arguments are coerced into a global regex
    assert.deepEqual(
        [...matchAll(str, nonRegexStr)],
        [...matchAll(str, new RegExp(nonRegexStr, 'g'))]
    );
     
    assert.deepEqual([...matchAll(str, globalRegex)], [
        Object.assign(['a'], { index: 0, input: str, groups: undefined }),
        Object.assign(['a'], { index: 1, input: str, groups: undefined }),
        Object.assign(['c'], { index: 3, input: str, groups: undefined }),
    ]);
     
    assert.deepEqual([...matchAll(str, nonGlobalRegex)], [
        Object.assign(['b'], { index: 2, input: str, groups: undefined }),
    ]);
     
    matchAll.shim(); // will be a no-op if not needed
     
    // non-regex arguments are coerced into a global regex
    assert.deepEqual(
        [...str.matchAll(nonRegexStr)],
        [...str.matchAll(new RegExp(nonRegexStr, 'g'))]
    );
     
    assert.deepEqual([...str.matchAll(globalRegex)], [
        Object.assign(['a'], { index: 0, input: str, groups: undefined }),
        Object.assign(['a'], { index: 1, input: str, groups: undefined }),
        Object.assign(['c'], { index: 3, input: str, groups: undefined }),
    ]);
     
    assert.deepEqual([...str.matchAll(nonGlobalRegex)], [
        Object.assign(['b'], { index: 2, input: str, groups: undefined }),
    ]);
     

    Tests

    Simply clone the repo, npm install, and run npm test

    Install

    npm i string.prototype.matchall@3.0.1

    Version

    3.0.1

    License

    MIT

    Unpacked Size

    38.2 kB

    Total Files

    21

    Last publish

    Collaborators

    • ljharb