npmpackage.info

Gathering detailed insights and metrics for natural-compare

Other packages similar to natural-compare

natural-compare-lite

1.4.0

Compare strings containing a mix of letters and numbers in the way a human being would in sort order.

string-natural-compare

3.0.1

Compare alphanumeric strings the same way a human would, using a natural order algorithm

@types/natural-compare

1.4.3

TypeScript definitions for natural-compare

@types/string-natural-compare

3.0.4

TypeScript definitions for string-natural-compare

Gathering detailed insights and metrics for natural-compare

natural-compare - 1.4.0 | npmpackage.info

natural-compare

Compare strings containing a mix of letters and numbers in the way a human being would in sort order.

1.4.0

112

MIT

JavaScript

412.00 B

6,911,046,878 4.5

Installations

npm install natural-compare

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

6.2.2

NPM Version

3.9.5 Score

99.8

Supply Chain

Quality

75.1

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

4

Closed

2

Merged

2

Issues

Open

0

Total

9

Closed

9

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

litejs

Download Statistics

Total Downloads

6,911,046,878

Last Day

7,418,505

Last Week

47,524,643

Last Month

196,290,294

Last Year

1,903,768,918

GitHub Statistics

MIT License

112 Stars

60 Commits

7 Forks

4 Watchers

2 Branches

3 Contributors

Updated on Apr 28, 2025

Bundle Size

617.00 B

Minified

412.00 B

Minified + Gzipped

Bundlephobia

Maintainers

View All 3 Contributors

Package Meta Information

Latest Version

1.4.0

Package Id

natural-compare@1.4.0

Size

2.45 kB

NPM Version

3.9.5

Node Version

6.2.2

Published on

Jul 22, 2016

Total Downloads

Cumulative downloads

Total Downloads

6,911,046,878

Last Day

13.1%

7,418,505

Compared to previous day

Last Week

10.8%

47,524,643

Compared to previous week

Last Month

1.3%

196,290,294

Compared to previous month

Last Year

24.8%

1,903,768,918

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

buildman testman

@version    1.4.0
@date       2015-10-26
@stability  3 - Stable

Natural Compare –

Compare strings containing a mix of letters and numbers in the way a human being would in sort order. This is described as a "natural ordering".

1Standard sorting:   Natural order sorting:
2    img1.png            img1.png
3    img10.png           img2.png
4    img12.png           img10.png
5    img2.png            img12.png

String.naturalCompare returns a number indicating whether a reference string comes before or after or is the same as the given string in sort order. Use it with builtin sort() function.

Installation

In browser

1<script src=min.natural-compare.js></script>

In node.js: npm install natural-compare-lite

1require("natural-compare-lite")

Usage

1// Simple case sensitive example
2var a = ["z1.doc", "z10.doc", "z17.doc", "z2.doc", "z23.doc", "z3.doc"];
3a.sort(String.naturalCompare);
4// ["z1.doc", "z2.doc", "z3.doc", "z10.doc", "z17.doc", "z23.doc"]
5
6// Use wrapper function for case insensitivity
7a.sort(function(a, b){
8  return String.naturalCompare(a.toLowerCase(), b.toLowerCase());
9})
10
11// In most cases we want to sort an array of objects
12var a = [ {"street":"350 5th Ave", "room":"A-1021"}
13        , {"street":"350 5th Ave", "room":"A-21046-b"} ];
14
15// sort by street, then by room
16a.sort(function(a, b){
17  return String.naturalCompare(a.street, b.street) || String.naturalCompare(a.room, b.room);
18})
19
20// When text transformation is needed (eg toLowerCase()),
21// it is best for performance to keep
22// transformed key in that object.
23// There are no need to do text transformation
24// on each comparision when sorting.
25var a = [ {"make":"Audi", "model":"A6"}
26        , {"make":"Kia",  "model":"Rio"} ];
27
28// sort by make, then by model
29a.map(function(car){
30  car.sort_key = (car.make + " " + car.model).toLowerCase();
31})
32a.sort(function(a, b){
33  return String.naturalCompare(a.sort_key, b.sort_key);
34})

Works well with dates in ISO format eg "Rev 2012-07-26.doc".

Custom alphabet

It is possible to configure a custom alphabet to achieve a desired order.

1// Estonian alphabet
2String.alphabet = "ABDEFGHIJKLMNOPRSŠZŽTUVÕÄÖÜXYabdefghijklmnoprsšzžtuvõäöüxy"
3["t", "z", "x", "õ"].sort(String.naturalCompare)
4// ["z", "t", "õ", "x"]
5
6// Russian alphabet
7String.alphabet = "АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя"
8["Ё", "А", "Б"].sort(String.naturalCompare)
9// ["А", "Б", "Ё"]

External links

[GitHub repo][https://github.com/litejs/natural-compare-lite]
jsperf test

Licence

No vulnerabilities found.

10

Security-Policy

Determines if the project has published a security policy.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

7

SAST

Determines if the project uses static code analysis.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

Score

4.5

/10

Last Scanned on 2025-05-05

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More