DefinitelyTyped/types/xml2json/index.d.ts
2017-03-24 14:27:52 -07:00

71 lines
2.1 KiB
TypeScript

// Type definitions for xml2json 0.10
// Project: https://github.com/buglabs/node-xml2json
// Definitions by: Dolan Miu <https://github.com/dolanmiu>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
export function toJson(xml: string, options?: { object?: false } & JsonOptions): string;
export function toJson(xml: string, options?: { object: true } & JsonOptions): {};
export function toXml(json: {} | string, options?: XmlOptions): string;
export interface XmlOptions {
/**
* Sanitizes the following characters present in element values (default false):
* @example
* var chars = {
* '<': '&lt;',
* '>': '&gt;',
* '(': '&#40;',
* ')': '&#41;',
* '#': '&#35;',
* '&': '&amp;',
* '"': '&quot;',
* "'": '&apos;'
* };
* @example
*/
sanitize?: boolean;
}
export interface JsonOptions {
/**
* Returns a Javascript object instead of a JSON string.
*/
// object?: boolean; // This is now overloaded in the toJson method
/**
* Makes the JSON reversible to XML.
* xml2json tranforms CDATA content to JSON, but it doesn't generate a reversible structure.
*/
reversible?: boolean;
/**
* Makes type coercion.
* i.e.: numbers and booleans present in attributes and element values are converted from string to its correspondent data types.
* Coerce can be optionally defined as an object with specific methods of coercion based on attribute name or tag name, with fallback to default coercion.
*/
coerce?: boolean;
/**
* Sanitizes the following characters present in element values (default true):
* @example
* var chars = {
* '<': '&lt;',
* '>': '&gt;',
* '(': '&#40;',
* ')': '&#41;',
* '#': '&#35;',
* '&': '&amp;',
* '"': '&quot;',
* "'": '&apos;'
* };
* @example
*/
sanitize?: boolean;
/**
* Removes leading and trailing whitespaces as well as line terminators in element values.
* Defaults to true.
*/
trim?: boolean;
/**
* XML child nodes are always treated as arrays
*/
arrayNotation?: boolean;
}