DefinitelyTyped/types/xml2json/index.d.ts
Igor Strebezhev 4feea74355 Update missing options fields at xml2json (#37954)
* Update missing options fields at xml2json

Options are described here:
9827264681/README.md

* Update index.d.ts
2019-08-28 16:53:32 -07:00

82 lines
2.6 KiB
TypeScript

// Type definitions for xml2json 0.11
// Project: https://github.com/buglabs/node-xml2json
// Definitions by: Dolan Miu <https://github.com/dolanmiu>
// Igor Strebezhev <https://github.com/xamgore>
// 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;
/**
* Ignores all null values.
*/
ignoreNull?: 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.
* You can specify a selective array of nodes for this to apply to instead of the whole document.
*/
arrayNotation?: boolean | string[];
/**
* Changes the default textNode property from $t to _t when option is set to true.
* Alternatively a string can be specified which will override $t to what ever the string is.
*/
alternateTextNode?: boolean;
}