sortobject

What is sortobject?

The sortobject npm package is a utility for sorting the keys of an object. It can be used to ensure consistent key ordering, which can be useful for tasks such as comparing objects, generating consistent JSON output, and more.

What are sortobject's main functionalities?

Sort object keys alphabetically

This feature sorts the keys of an object in alphabetical order. The code sample demonstrates how to use the sortobject package to sort the keys of an object.

const sortobject = require('sortobject');
const obj = { b: 2, a: 1, c: 3 };
const sortedObj = sortobject(obj);
console.log(sortedObj); // { a: 1, b: 2, c: 3 }

Sort nested object keys

This feature sorts the keys of nested objects as well. The code sample shows how nested objects are sorted by their keys.

const sortobject = require('sortobject');
const obj = { b: { d: 4, c: 3 }, a: 1 };
const sortedObj = sortobject(obj);
console.log(sortedObj); // { a: 1, b: { c: 3, d: 4 } }

Other packages similar to sortobject

sort-keys

The sort-keys package sorts the keys of an object in a similar manner to sortobject. It offers additional options such as sorting in reverse order and custom sorting functions. Compared to sortobject, sort-keys provides more flexibility in how the keys are sorted.

deep-sort-object

The deep-sort-object package sorts the keys of an object deeply, including nested objects. It is similar to sortobject in that it handles nested objects, but it also provides more control over the sorting process, such as custom sorting functions.

README

Sort Object

Returns a copy of an object, sorted deeply by its keys, without mangling any arrays inside of it

Install

NPM

• Install: npm install --save sortobject
• Module: require('sortobject')

Browserify

• Install: npm install --save sortobject
• Module: require('sortobject')
• CDN URL: //wzrd.in/bundle/sortobject@1.1.0

Ender

• Install: ender add sortobject
• Module: require('sortobject')

Editions

This package is published with the following editions:

• sortobject aliases sortobject/index.js which uses Editions to automatically select the correct edition for the consumers environment
• sortobject/source/index.js is Source + ESNext + Require
• sortobject/es2015/index.js is Babel Compiled + ES2015 + Require

Older environments may need Babel's Polyfill or something similar.

Usage

var sortObject = require('sortobject')
var fixture = {
    "c": true,
    "a": true,
    "b": null,
    "d": [
        {
            "c": true,
            "a": true,
            "b": null
        },
        {
            "c": true,
            "a": true,
            "b": null,
            "d": [
                {
                    "c": true,
                    "a": true,
                    "b": null
                }
            ]
        }
    ]
}
var actual = sortObject(fixture)
console.log(JSON.stringify(actual,null,4))  /* {
    "a": true,
    "b": null,
    "c": true,
    "d": [
        {
            "a": true,
            "b": null,
            "c": true
        },
        {
            "a": true,
            "b": null,
            "c": true,
            "d": [
                {
                    "a": true,
                    "b": null,
                    "c": true
                }
            ]
        }
    ]
} */

History

Discover the release history by heading on over to the HISTORY.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

• Benjamin Lupton — view contributions

Sponsors

These amazing people have contributed finances to this project:

• SimpleTee

Become a sponsor!

Contributors

These amazing people have contributed code to this project:

• Benjamin Lupton — view contributions
• Serge Havas — view contributions

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

• Copyright © 2012+ Bevry Pty Ltd

and licensed under:

• MIT License

Changelog

v1.1.0 2016 May 2

• Converted from CoffeeScript to JavaScript
• Updated base files