google-json-style-serializer v1.0.3
Google JSON Style Serializer
Serializer for JSON objects using Google's JSON style guide, with a focus on user simplicity.
Usage
Serializing Data
import GoogleJSONSeralizer from "google-json-style-serializer";
const serializer = new GoogleJSONSerializer.DataSerializer(opts);
const serializedData = serializer.serialize(dataToSerialize);
opts
is an object with the properties:
topLevel
- options relating to the top level properties of the serialized JSON object. These options are described heredata
- options relating specifically to the JSON data. These options are described here, as well as here for paging and here for links
dataToSerialize
can be any object or array of objects. If dataToSerialize
is an array, the data is serialized under data.items
of the serialized data. If dataToSerialize
is an object, then it's fields are added directly to the data
feld of the serialized data object.
Serializing Errors
import GoogleJSONSeralizer from "google-json-style-serializer";
const serializer = new GoogleJSONSerializer.ErrorSerializer(opts);
const serializedData = serializer.serialize(errorsToSerialize);
opts
is an object with the properties:
topLevel
- options relating to the top level properties of the serialized JSON object. These options are described hereerror
- options relating specifically to the serialized errors. These options are described here
errorsToSerialize
can be an Error
or an array of Error
(or any subclass of Error
). If errorsToSerialize
is an array, the errors are serialized under the error.errors
field of the serialized object, where each entry has a message
and reason
field. If errorsToSerialize
is an Error
object, only the message is given under error.message
.
If error.errors
is given under opts
, the fields of error.errors
are mapped to each error given in errorsToSerialize
(if errorsToSerialize
is an Error
, then it is just mapped to the first element of error.errors
.) If these arrays are not the same in length, an exception is thrown.