Fast-sort is a lightweight (850 bytes gzip), zero-dependency sorting library with TypeScript support.
Its easy-to-use and flexible syntax, combined with incredible speed , make it a top choice for developers seeking efficient, reliable, and customizable sorting solutions.
Quick examples
import { sort } from 'fast-sort'; // Sort flat arrays const ascSorted = sort([1,4,2]).asc(); // => [1, 2, 4] const descSorted = sort([1, 4, 2]).desc(); // => [4, 2, 1] // Sort users (array of objects) by firstName in descending order const sorted = sort(users).desc(u => u.firstName); // Sort users in ascending order by firstName and lastName const sorted = sort(users).asc([ u => u.firstName, u
Fast-sort provides an inPlace sorting option that mutates the original array instead of creating a new instance, resulting in marginally faster and more memory-efficient sorting. However, both the inPlaceSort and default sort methods offer exactly the same functionality.
By default fast-sort is not doing language sensitive sorting of strings.
e.g 'image-11.jpg' will be sorted before 'image-2.jpg' (in ascending sorting).
We can provide custom Intl.Collator comparer to fast-sort for language sensitive sorting of strings.
Keep in mind that natural sort is slower then default sorting so recommendation is to use it
only when needed.
import { sort, createNewSortInstance } from 'fast-sort'; const testArr = ['image-2.jpg', 'image-11.jpg', 'image-3.jpg']; // By default fast-sort is not doing natural sort sort(testArr).desc(); // => ['image-3.jpg', 'image-2.jpg', 'image-11.jpg'] // We can use `by` sort to override default comparer // with the one that is doing language sensitive comparison sort(testArr).by({ desc: true, comparer: new Intl.Collator(undefined, { numeric: true, sensitivity: 'base' }).compare, }); // => ['image-11.jpg', 'image-3.jpg', 'image-2.jpg'] // Or we can create new sort instance with language sensitive comparer. // Recommended if used in multiple places const naturalSort
Fast sort can be tailored to fit any sorting need or use case by:
creating custom sorting instances
overriding default comparer in by sorter
custom handling in provided callback function
combination of any from above
For example we will sort tags by "custom" tag importance (e.g vip tag is of greater importance then captain tag).
import { sort, createNewSortInstance } from 'fast-sort'; const tags = ['influencer', 'unknown', 'vip', 'captain']; const tagsImportance = { // Domain specific tag importance vip: 3, influencer: 2, captain: 1, }; // We can use power of computed prop to sort tags by domain specific importance const descTags = sort(tags).desc(tag => tagImportance[tag] || 0); // => ['vip', 'influencer', 'captain', 'unknown']; // Or we can create specialized tagSorter so we can reuse it in multiple places const tagSorter = createNewSortInstance
More examples
// Sorting values that are not sortable will return same value back sort(null).asc(); // => null sort(33).desc(); // => 33 // By default fast-sort sorts null and undefined values to the // bottom no matter if sorting is in asc or decs order. // If this is not intended behaviour you can check "Should create sort instance that sorts nil value to the top in desc order" test on how to override const addresses = [{ city: 'Split' }, { city: undefined }, { city: 'Zagreb'}]; sort(addresses).asc(a => a.city); // => Split, Zagreb, undefined sort(addresses).desc(a => a.city); // => Zagreb, Split, undefined
Migrating from older versions
Documentation for v2 and older versions is available here.
For migrating to v3 you can reference CHANGELOG for what has been changed.
Benchmark
Five different benchmarks have been created to get better insight of how fast-sort perform under different scenarios.
Each benchmark is run with different array sizes raging from small 100 items to large 100 000 items.
Every run of benchmark outputs different results but the results are constantly showing better scores compared to similar popular sorting libraries.