Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »

string.prototype.matchall

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

Downloadsweekly downloads

537,978

version

3.0.1

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability