# json.sortify

> A deterministic version of JSON.stringify that sorts object keys alphabetically.

Latest version **2.2.2** (published 2017-08-31) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install json.sortify
pnpm add json.sortify
yarn add json.sortify
bun add json.sortify
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.2.2 |
| Published | 2017-08-31 |
| First published | 2015-07-20 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=4.0.0 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 36 |
| Author | Thomas Rosenau |
| Maintainers | thomasr |
| Keywords | JSON, deterministic, stringify, sort, hash |

## Links

- npm: https://www.npmjs.com/package/json.sortify
- Repository: https://github.com/ThomasR/JSON.sortify
- Issues: https://github.com/ThomasR/JSON.sortify/issues
- npm.io page: https://npm.io/package/json.sortify

## Alternatives

- [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads
- [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads
- [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads
- [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads
- [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads

## Recent versions

- 2.2.2 (latest) — 2017-08-31
- 2.1.0 — 2017-08-31
- 2.2.1 — 2017-01-13
- 2.0.2 — 2016-03-15
- 1.0.3 — 2016-03-15
- 2.0.1 — 2016-03-15
- 2.0.0 — 2016-03-11
- 1.0.2 — 2015-07-20
- 1.0.1 — 2015-07-20

## README

JSON.sortify
=====
[![npm version](https://img.shields.io/npm/v/json.sortify.svg)](https://www.npmjs.com/package/json.sortify)
[![Build Status](https://img.shields.io/travis/ThomasR/JSON.sortify.svg)](https://travis-ci.org/ThomasR/JSON.sortify)
[![Test Coverage](https://img.shields.io/codeclimate/coverage/github/ThomasR/JSON.sortify.svg)](https://codeclimate.com/github/ThomasR/JSON.sortify/coverage)
[![Code Climate](https://img.shields.io/codeclimate/github/ThomasR/JSON.sortify.svg)](https://codeclimate.com/github/ThomasR/JSON.sortify/code)

A deterministic version of `JSON.stringify` that sorts object keys alphabetically.

Inspired by [http://stackoverflow.com/questions/8931967/is-there-a-deterministic-equivalent-of-json-stringify](http://stackoverflow.com/questions/8931967/is-there-a-deterministic-equivalent-of-json-stringify)


## Install as an NPM module

```bash
$ npm install json.sortify
```

### Usage

```JavaScript
let jsonSortify = require('json.sortify');
```

or

```JavaScript
JSON.sortify = require('json.sortify');
```

or even
```JavaScript
JSON.stringify = require('json.sortify');
```

JSON.sortify is fully compatible with JSON.stringify, so you can overwrite the native implementation without any problems.

## In HTML

Download [JSON.sortify.js](dist/JSON.sortify.js) and save it to your server.

```html
<script src="JSON.sortify.js"></script> <!-- will inject the JSON.sortify() function -->
```

Or, if you're using [bower](http://bower.io/), type `bower install json.sortify`.

```html
<script src="bower_components/json.sortify/dist/JSON.sortify.js"></script>
```

`JSON.sortify` can be used exactly like `JSON.stringify`. As mentioned above, you can overwrite JSON.stringify if you want to:

```html
<script src="JSON.sortify.js"></script>
<script>JSON.stringify = JSON.sortify</script>
```

### AMD module

You can also use JSON.sortify as an AMD module:

```JavaScript
require(['json.sortify'], function (jsonSortify) { … });
```

## How to use

Use `JSON.sortify` exactly like `JSON.stringify`. Refer to [MDN:JSON/stringify](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) for details.

### Basic

```JavaScript
JSON.sortify({a:1,b:2});
```
```Text
{"a":1,"b":2}
```


### Sorting

```JavaScript
JSON.sortify({b:1,a:2,c:3,5:4});
```
```Text
{"5":4,"a":2,"b":1,"c":3}
```


### Indentation:

```JavaScript
JSON.sortify({b:1,a:2}, null, 2);
```
```Text
{
  "a": 2,
  "b": 1
}
```


### Whitelisting of object keys:

```JavaScript
JSON.sortify({b:1,foo:2,a:3}, ['a', 'foo'], 4);
```
```Text
{
    "a": 3,
    "foo": 2
}
```


### Replacer Function:

```JavaScript
JSON.sortify({b:1,foo:'woot',a:3}, function (key, value) {
    return typeof value == 'string' ? value + '!!!' : value;
}, '\t');
```
```Text
{
        "a": 3,
        "b": 1,
        "foo": "woot!!!"
}
```


[![License: Apache 2.0](https://img.shields.io/github/license/ThomasR/JSON.sortify.svg)](LICENSE)

---
_Source: https://npm.io/package/json.sortify · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._