API: json JSON (YUI Library)

_char

Escapes a special character to a safe Unicode representation

Parameters:: c <String> single character to escape

Returns: String: safe Unicode escape

_isValid

Four step determination whether a string is valid JSON. In three steps, escape sequences, safe values, and properly placed open square brackets are replaced with placeholders or removed. Then in the final step, the result of all these replacements is checked for invalid characters.

Parameters:: str <String> JSON string to be tested

Returns: boolean: is the string safe for eval?

_prepare

Replace certain Unicode characters that may be handled incorrectly by some browser implementations.

Parameters:: s <String> parse input

Returns: String: sanitized JSON string ready to be validated/parsed

_revive

Traverses nested objects, applying a filter or reviver function to each value. The value returned from the function will replace the original value in the key:value pair. If the value returned is undefined, the key will be omitted from the returned object.

Parameters:: data <MIXED> Any JavaScript data; reviver <Function> filter or mutation function

Returns: MIXED: The results of the filtered/mutated data structure

_string

Enclose escaped strings in quotes

Parameters:: s <String> string to wrap

Returns: String: '"'+s+'"' after s has had special characters escaped

_stringify

Worker function used by public stringify.

Parameters:: h <Object> object holding the key; key <String> String key in object h to serialize; depth <Number> depth to serialize; w <Array|Function> array of whitelisted keys OR replacer function; pstack <Array> used to protect against recursion

Returns: String: serialized version of o

dateToString


                                        
                                         static 
                                        
                                        String
                                            dateToString
                                           (
                                                
                                                        
                                                         d
                                                    
                                                
                                            )

Serializes a Date instance as a UTC date string. Used internally by stringify. Override this method if you need Dates serialized in a different format.

Parameters:: d <Date> The Date to serialize

Returns: String: stringified Date in UTC format YYYY-MM-DDTHH:mm:SSZ

isValid

Parameters:: str <String> JSON string to be tested

Returns: boolean: is the string safe for eval?

parse

Parse a JSON string, returning the native JavaScript representation. Only minor modifications from http://www.json.org/json2.js.

Parameters:: s <string> JSON string data; reviver <function> (optional) function(k,v) passed each key:value pair of object literals, allowing pruning or altering values

Returns: MIXED: the native JavaScript representation of the JSON string

stringify

Converts an arbitrary value to a JSON string representation. Cyclical object or array references are replaced with null. If a whitelist is provided, only matching object keys will be included. If a depth limit is provided, objects and arrays at that depth will be stringified as empty.

Parameters:: o <MIXED> any arbitrary object to convert to JSON string; w <Array|Function> (optional) whitelist of acceptable object keys to include OR a function(value,key) to alter values before serialization; d <number> (optional) depth limit to recurse objects/arrays (practical minimum 1)

Returns: string: JSON string representation of the input

stringToDate


                                        
                                        
                                        
                                        Date
                                            stringToDate
                                           (
                                                
                                                        
                                                         str
                                                    
                                                
                                            )

Reconstitute Date instances from the default JSON UTC serialization. Reference this from a reviver function to rebuild Dates during the parse operation.

Parameters:: str <String> String serialization of a Date

Returns: Date

Yahoo! UI Library

json 2.6.0

`static` Class JSON

Properties

_BRACKETS `- private static {RegExp}`

_CHARS `- private static {Object}`

_ESCAPES `- private static {RegExp}`

_INVALID `- private static {RegExp}`

_SPECIAL_CHARS `- private static {RegExp}`

_UNICODE_EXCEPTIONS `- private {RegExp}`

_VALUES `- private static {RegExp}`

Methods

_char

_isValid

_prepare

_revive

_string

_stringify

dateToString

isValid

parse

stringify

stringToDate

Modules

Classes

Files

Properties

Methods

Yahoo! UI Library

json 2.6.0

static Class JSON

Properties

_BRACKETS - private static {RegExp}

_CHARS - private static {Object}

_ESCAPES - private static {RegExp}

_INVALID - private static {RegExp}

_SPECIAL_CHARS - private static {RegExp}

_UNICODE_EXCEPTIONS - private {RegExp}

_VALUES - private static {RegExp}

Methods

Modules

Classes

Files

Properties

Methods

`static` Class JSON

_BRACKETS `- private static {RegExp}`

_CHARS `- private static {Object}`

_ESCAPES `- private static {RegExp}`

_INVALID `- private static {RegExp}`

_SPECIAL_CHARS `- private static {RegExp}`

_UNICODE_EXCEPTIONS `- private {RegExp}`

_VALUES `- private static {RegExp}`