array.prototype.tosorted

An ESnext spec-compliant Array.prototype.toSorted shim/polyfill/replacement that works as far down as ES3.

  • Types
  • ESM
  • CJS
License
MIT
Install Size
20.9 kB(4.7 MB)
Vulns
0
Published

Get started

$npm install array.prototype.tosorted
$pnpm add array.prototype.tosorted
$yarn add array.prototype.tosorted
$bun add array.prototype.tosorted
$deno add npm:array.prototype.tosorted
$vlt install array.prototype.tosorted
$vp add array.prototype.tosorted

You might not need this dependency.

This package can be replaced with Array.prototype.toSorted, available since Node 20.0.0.Learn more

Readme

array.prototype.tosorted Version Badge

dependency status dev dependency status License Downloads

npm badge

An ESnext spec-compliant Array.prototype.toSorted shim/polyfill/replacement that works as far down as ES3.

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

Because Array.prototype.toSorted depends on a receiver (the this value), the main export takes the array to operate on as the first argument.

Getting started

npm install --save array.prototype.tosorted

Usage/Examples

var toSorted = require('array.prototype.tosorted');
var assert = require('assert');

var input = [5, 4, 3, 2, 1, 0];

var output = toSorted(input);

assert.deepEqual(output, [0, 1, 2, 3, 4, 5]);
assert.notEqual(output, input);
assert.deepEqual(input, [5, 4, 3, 2, 1, 0]);
var toSorted = require('array.prototype.tosorted');
var assert = require('assert');
/* when Array#toSorted is not present */
delete Array.prototype.toSorted;
var shimmed = toSorted.shim();

assert.equal(shimmed, toSorted.getPolyfill());
assert.deepEqual(input.toSorted(), toSorted(input));
var toSorted = require('array.prototype.tosorted');
var assert = require('assert');
/* when Array#toSorted is present */
var shimmed = toSorted.shim();

assert.equal(shimmed, Array.prototype.toSorted);
assert.deepEqual(input.toSorted(), toSorted(input));

Tests

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