You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
94 lines
2.3 KiB
94 lines
2.3 KiB
# json-schema-deref-sync
|
|
|
|
[](https://www.npmjs.com/package/json-schema-deref-sync)
|
|
[](https://travis-ci.org/bojand/json-schema-deref-sync)
|
|
[](https://standardjs.com)
|
|
[](https://raw.githubusercontent.com/bojand/json-schema-deref-sync/master/LICENSE)
|
|
|
|
Dereference JSON pointers in a JSON schemas with their true resolved values.
|
|
Basically a lighter, synchronous version of [json-schema-deref](https://github.com/bojand/json-schema-deref) but omits web references.
|
|
|
|
## Installation
|
|
|
|
`npm install json-schema-deref-sync`
|
|
|
|
## Overview
|
|
|
|
Let's say you have the following JSON Schema:
|
|
|
|
```json
|
|
{
|
|
"description": "Just some JSON schema.",
|
|
"title": "Basic Widget",
|
|
"type": "object",
|
|
"definitions": {
|
|
"id": {
|
|
"description": "unique identifier",
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"readOnly": true
|
|
}
|
|
},
|
|
"properties": {
|
|
"id": {
|
|
"$ref": "#/definitions/id"
|
|
},
|
|
"foo": {
|
|
"$ref": "http://www.mysite.com/myschema.json#/definitions/foo"
|
|
},
|
|
"bar": {
|
|
"$ref": "bar.json"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Sometimes you just want that schema to be fully expanded, with `$ref`'s being their (true) resolved values:
|
|
|
|
```json
|
|
{
|
|
"description": "Just some JSON schema.",
|
|
"title": "Basic Widget",
|
|
"type": "object",
|
|
"definitions": {
|
|
"id": {
|
|
"description": "unique identifier",
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"readOnly": true
|
|
}
|
|
},
|
|
"properties": {
|
|
"id": {
|
|
"description": "unique identifier",
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"readOnly": true
|
|
},
|
|
"foo": {
|
|
"description": "foo property",
|
|
"readOnly": true,
|
|
"type": "number"
|
|
},
|
|
"bar": {
|
|
"description": "bar property",
|
|
"type": "boolean"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
This utility lets you do that:
|
|
|
|
|
|
```js
|
|
var deref = require('json-schema-deref-sync');
|
|
var myschema = require('schema.json');
|
|
|
|
var fullSchema = deref(myschema);
|
|
```
|
|
|
|
## API Reference
|
|
|
|
{{>all-docs~}}
|