510 lines
46 KiB
HTML
510 lines
46 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html>
|
|
<head>
|
|
<title>API: json JSON.js (YUI Library)</title>
|
|
<link rel="stylesheet" type="text/css" href="assets/api.css">
|
|
<script type="text/javascript" src="assets/api-js"></script>
|
|
<script type="text/javascript" src="assets/ac-js"></script>
|
|
</head>
|
|
|
|
<body id="yahoo-com">
|
|
|
|
<div id="doc3" class="yui-t2">
|
|
|
|
<div id="hd">
|
|
<a href="http://developer.yahoo.com/yui/"><h1>Yahoo! UI Library</h1></a>
|
|
<h3>json <span class="subtitle">2.5.1</span></h3>
|
|
<p>
|
|
<a href="./index.html">Yahoo! UI Library</a>
|
|
> <a href="./module_json.html">json</a>
|
|
|
|
> JSON.js (source view)
|
|
</p>
|
|
|
|
</div>
|
|
|
|
<div id="bd">
|
|
<div id="yui-main">
|
|
<div class="yui-b">
|
|
<form name="yui-classopts-form">
|
|
<span id="classopts"><input type="checkbox" name="showprivate" id="showprivate" /> Show Private</span>
|
|
<span id="classopts"><input type="checkbox" name="showprotected" id="showprotected" /> Show Protected</span>
|
|
</form>
|
|
|
|
<div id="srcout">
|
|
<style>
|
|
#doc3 #classopts { display:none; }
|
|
</style>
|
|
<div class="highlight" ><pre><span class="nx">YAHOO</span><span class="o">.</span><span class="nx">namespace</span><span class="o">(</span><span class="s1">'lang'</span><span class="o">);</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Provides methods to parse JSON strings and convert objects to JSON strings.</span>
|
|
<span class="c"> * @module json</span>
|
|
<span class="c"> * @requires yahoo</span>
|
|
<span class="c"> * @class YAHOO.lang.JSON</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">YAHOO</span><span class="o">.</span><span class="nx">lang</span><span class="o">.</span><span class="nx">JSON</span> <span class="o">=</span> <span class="o">{</span>
|
|
<span class="c">/**</span>
|
|
<span class="c"> * First step in the validation. Regex used to replace all escape</span>
|
|
<span class="c"> * sequences (i.e. "\\", etc) with '@' characters (a non-JSON character).</span>
|
|
<span class="c"> * @property _ESCAPES</span>
|
|
<span class="c"> * @type {RegExp}</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_ESCAPES</span> <span class="o">:</span> <span class="sr">/\\["\\\/bfnrtu]/g</span><span class="o">,</span>
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Second step in the validation. Regex used to replace all simple</span>
|
|
<span class="c"> * values with ']' characters.</span>
|
|
<span class="c"> * @property _VALUES</span>
|
|
<span class="c"> * @type {RegExp}</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_VALUES</span> <span class="o">:</span> <span class="sr">/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g</span><span class="o">,</span>
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Third step in the validation. Regex used to remove all open square</span>
|
|
<span class="c"> * brackets following a colon, comma, or at the beginning of the string.</span>
|
|
<span class="c"> * @property _BRACKETS</span>
|
|
<span class="c"> * @type {RegExp}</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_BRACKETS</span> <span class="o">:</span> <span class="sr">/(?:^|:|,)(?:\s*\[)+/g</span><span class="o">,</span>
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Final step in the validation. Regex used to test the string left after</span>
|
|
<span class="c"> * all previous replacements for invalid characters.</span>
|
|
<span class="c"> * @property _INVALID</span>
|
|
<span class="c"> * @type {RegExp}</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_INVALID</span> <span class="o">:</span> <span class="sr">/^[\],:{}\s]*$/</span><span class="o">,</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Regex used to replace special characters in strings for JSON</span>
|
|
<span class="c"> * stringification.</span>
|
|
<span class="c"> * @property _SPECIAL_CHARS</span>
|
|
<span class="c"> * @type {RegExp}</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_SPECIAL_CHARS</span> <span class="o">:</span> <span class="sr">/["\\\x00-\x1f\x7f-\x9f]/g</span><span class="o">,</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Regex used to reconstitute serialized Dates.</span>
|
|
<span class="c"> * @property _PARSE_DATE</span>
|
|
<span class="c"> * @type {RegExp}</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_PARSE_DATE</span> <span class="o">:</span> <span class="sr">/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})Z$/</span><span class="o">,</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Character substitution map for common escapes and special characters.</span>
|
|
<span class="c"> * @property _CHARS</span>
|
|
<span class="c"> * @type {Object}</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_CHARS</span> <span class="o">:</span> <span class="o">{</span>
|
|
<span class="s1">'\b'</span><span class="o">:</span> <span class="s1">'\\b'</span><span class="o">,</span>
|
|
<span class="s1">'\t'</span><span class="o">:</span> <span class="s1">'\\t'</span><span class="o">,</span>
|
|
<span class="s1">'\n'</span><span class="o">:</span> <span class="s1">'\\n'</span><span class="o">,</span>
|
|
<span class="s1">'\f'</span><span class="o">:</span> <span class="s1">'\\f'</span><span class="o">,</span>
|
|
<span class="s1">'\r'</span><span class="o">:</span> <span class="s1">'\\r'</span><span class="o">,</span>
|
|
<span class="s1">'"'</span> <span class="o">:</span> <span class="s1">'\\"'</span><span class="o">,</span>
|
|
<span class="s1">'\\'</span><span class="o">:</span> <span class="s1">'\\\\'</span>
|
|
<span class="o">},</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Traverses nested objects, applying a filter or mutation function to</span>
|
|
<span class="c"> * each value. The value returned from the function will replace the</span>
|
|
<span class="c"> * original value in the key:value pair. If the value returned is</span>
|
|
<span class="c"> * undefined, the key will be omitted from the returned object.</span>
|
|
<span class="c"> * @method _applyFilter</span>
|
|
<span class="c"> * @param data {MIXED} Any JavaScript data</span>
|
|
<span class="c"> * @param filter {Function} filter or mutation function</span>
|
|
<span class="c"> * @return {MIXED} The results of the filtered data</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @private</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">_applyFilter</span> <span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">data</span><span class="o">,</span> <span class="nx">filter</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">var</span> <span class="nx">walk</span> <span class="o">=</span> <span class="k">function</span> <span class="o">(</span><span class="nx">k</span><span class="o">,</span><span class="nx">v</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">var</span> <span class="nx">i</span><span class="o">,</span> <span class="nx">n</span><span class="o">;</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">v</span> <span class="o">&&</span> <span class="k">typeof</span> <span class="nx">v</span> <span class="o">===</span> <span class="s1">'object'</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="k">in</span> <span class="nx">v</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">YAHOO</span><span class="o">.</span><span class="nx">lang</span><span class="o">.</span><span class="nx">hasOwnProperty</span><span class="o">(</span><span class="nx">v</span><span class="o">,</span><span class="nx">i</span><span class="o">))</span> <span class="o">{</span>
|
|
<span class="nx">n</span> <span class="o">=</span> <span class="nx">walk</span><span class="o">(</span><span class="nx">i</span><span class="o">,</span> <span class="nx">v</span><span class="o">[</span><span class="nx">i</span><span class="o">]);</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">n</span> <span class="o">===</span> <span class="kc">undefined</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="nx">delete</span> <span class="nx">v</span><span class="o">[</span><span class="nx">i</span><span class="o">];</span>
|
|
<span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
|
|
<span class="nx">v</span><span class="o">[</span><span class="nx">i</span><span class="o">]</span> <span class="o">=</span> <span class="nx">n</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
<span class="k">return</span> <span class="nx">filter</span><span class="o">(</span><span class="nx">k</span><span class="o">,</span> <span class="nx">v</span><span class="o">);</span>
|
|
<span class="o">};</span>
|
|
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">YAHOO</span><span class="o">.</span><span class="nx">lang</span><span class="o">.</span><span class="nx">isFunction</span><span class="o">(</span><span class="nx">filter</span><span class="o">))</span> <span class="o">{</span>
|
|
<span class="nx">walk</span><span class="o">(</span><span class="s1">''</span><span class="o">,</span><span class="nx">data</span><span class="o">);</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="k">return</span> <span class="nx">data</span><span class="o">;</span>
|
|
<span class="o">},</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Four step determination whether a string is valid JSON. In three steps,</span>
|
|
<span class="c"> * escape sequences, safe values, and properly placed open square brackets</span>
|
|
<span class="c"> * are replaced with placeholders or removed. Then in the final step, the</span>
|
|
<span class="c"> * result of all these replacements is checked for invalid characters.</span>
|
|
<span class="c"> * @method isValid</span>
|
|
<span class="c"> * @param str {String} JSON string to be tested</span>
|
|
<span class="c"> * @return {boolean} is the string safe for eval?</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">isValid</span> <span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">str</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(!</span><span class="nx">YAHOO</span><span class="o">.</span><span class="nx">lang</span><span class="o">.</span><span class="nx">isString</span><span class="o">(</span><span class="nx">str</span><span class="o">))</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="kc">false</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_INVALID</span><span class="o">.</span><span class="nx">test</span><span class="o">(</span><span class="nx">str</span><span class="o">.</span>
|
|
<span class="nx">replace</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_ESCAPES</span><span class="o">,</span><span class="s1">'@'</span><span class="o">).</span>
|
|
<span class="nx">replace</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_VALUES</span><span class="o">,</span><span class="s1">']'</span><span class="o">).</span>
|
|
<span class="nx">replace</span><span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_BRACKETS</span><span class="o">,</span><span class="s1">''</span><span class="o">));</span>
|
|
<span class="o">},</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Serializes a Date instance as a UTC date string. Used internally by</span>
|
|
<span class="c"> * stringify. Override this method if you need Dates serialized in a</span>
|
|
<span class="c"> * different format.</span>
|
|
<span class="c"> * @method dateToString</span>
|
|
<span class="c"> * @param d {Date} The Date to serialize</span>
|
|
<span class="c"> * @return {String} stringified Date in UTC format YYYY-MM-DDTHH:mm:SSZ</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">dateToString</span> <span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">d</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">function</span> <span class="nx">_zeroPad</span><span class="o">(</span><span class="nx">v</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="nx">v</span> <span class="o"><</span> <span class="m">10</span> <span class="o">?</span> <span class="s1">'0'</span> <span class="o">+</span> <span class="nx">v</span> <span class="o">:</span> <span class="nx">v</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="k">return</span> <span class="s1">'"'</span> <span class="o">+</span> <span class="nx">d</span><span class="o">.</span><span class="nx">getUTCFullYear</span><span class="o">()</span> <span class="o">+</span> <span class="s1">'-'</span> <span class="o">+</span>
|
|
<span class="nx">_zeroPad</span><span class="o">(</span><span class="nx">d</span><span class="o">.</span><span class="nx">getUTCMonth</span><span class="o">()</span> <span class="o">+</span> <span class="m">1</span><span class="o">)</span> <span class="o">+</span> <span class="s1">'-'</span> <span class="o">+</span>
|
|
<span class="nx">_zeroPad</span><span class="o">(</span><span class="nx">d</span><span class="o">.</span><span class="nx">getUTCDate</span><span class="o">())</span> <span class="o">+</span> <span class="s1">'T'</span> <span class="o">+</span>
|
|
<span class="nx">_zeroPad</span><span class="o">(</span><span class="nx">d</span><span class="o">.</span><span class="nx">getUTCHours</span><span class="o">())</span> <span class="o">+</span> <span class="s1">':'</span> <span class="o">+</span>
|
|
<span class="nx">_zeroPad</span><span class="o">(</span><span class="nx">d</span><span class="o">.</span><span class="nx">getUTCMinutes</span><span class="o">())</span> <span class="o">+</span> <span class="s1">':'</span> <span class="o">+</span>
|
|
<span class="nx">_zeroPad</span><span class="o">(</span><span class="nx">d</span><span class="o">.</span><span class="nx">getUTCSeconds</span><span class="o">())</span> <span class="o">+</span> <span class="s1">'Z"'</span><span class="o">;</span>
|
|
<span class="o">},</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Reconstitute Date instances from the default JSON UTC serialization.</span>
|
|
<span class="c"> * Reference this from a parse filter function to rebuild Dates during the</span>
|
|
<span class="c"> * parse operation.</span>
|
|
<span class="c"> * @method stringToDate</span>
|
|
<span class="c"> * @param str {String} String serialization of a Date</span>
|
|
<span class="c"> * @return {Date}</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">stringToDate</span> <span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">str</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">_PARSE_DATE</span><span class="o">.</span><span class="nx">test</span><span class="o">(</span><span class="nx">str</span><span class="o">))</span> <span class="o">{</span>
|
|
<span class="k">var</span> <span class="nx">d</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Date</span><span class="o">();</span>
|
|
<span class="nx">d</span><span class="o">.</span><span class="nx">setUTCFullYear</span><span class="o">(</span><span class="nb">RegExp</span><span class="o">.</span><span class="nx">$1</span><span class="o">,</span> <span class="o">(</span><span class="nb">RegExp</span><span class="o">.</span><span class="nx">$2</span><span class="o">|</span><span class="m">0</span><span class="o">)-</span><span class="m">1</span><span class="o">,</span> <span class="nb">RegExp</span><span class="o">.</span><span class="nx">$3</span><span class="o">);</span>
|
|
<span class="nx">d</span><span class="o">.</span><span class="nx">setUTCHours</span><span class="o">(</span><span class="nb">RegExp</span><span class="o">.</span><span class="nx">$4</span><span class="o">,</span> <span class="nb">RegExp</span><span class="o">.</span><span class="nx">$5</span><span class="o">,</span> <span class="nb">RegExp</span><span class="o">.</span><span class="nx">$6</span><span class="o">);</span>
|
|
<span class="k">return</span> <span class="nx">d</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
<span class="o">},</span>
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Parse a JSON string, returning the native JavaScript representation.</span>
|
|
<span class="c"> * Only minor modifications from http://www.json.org/json.js.</span>
|
|
<span class="c"> * @param s {string} JSON string data</span>
|
|
<span class="c"> * @param filter {function} (optional) function(k,v) passed each key value pair of object literals, allowing pruning or altering values</span>
|
|
<span class="c"> * @return {MIXED} the native JavaScript representation of the JSON string</span>
|
|
<span class="c"> * @throws SyntaxError</span>
|
|
<span class="c"> * @method parse</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @public</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">parse</span> <span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">s</span><span class="o">,</span><span class="nx">filter</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="c">// Ensure valid JSON</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="k">this</span><span class="o">.</span><span class="nx">isValid</span><span class="o">(</span><span class="nx">s</span><span class="o">))</span> <span class="o">{</span>
|
|
<span class="c">// Eval the text into a JavaScript data structure, apply any</span>
|
|
<span class="c"></span> <span class="c">// filter function, and return</span>
|
|
<span class="c"></span> <span class="k">return</span> <span class="k">this</span><span class="o">.</span><span class="nx">_applyFilter</span><span class="o">(</span> <span class="nb">eval</span><span class="o">(</span><span class="s1">'('</span> <span class="o">+</span> <span class="nx">s</span> <span class="o">+</span> <span class="s1">')'</span><span class="o">),</span> <span class="nx">filter</span> <span class="o">);</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// The text is not JSON parsable</span>
|
|
<span class="c"></span> <span class="k">throw</span> <span class="k">new</span> <span class="nx">SyntaxError</span><span class="o">(</span><span class="s1">'parseJSON'</span><span class="o">);</span>
|
|
<span class="o">},</span>
|
|
|
|
|
|
<span class="c">/**</span>
|
|
<span class="c"> * Converts an arbitrary value to a JSON string representation.</span>
|
|
<span class="c"> * Cyclical object or array references are replaced with null.</span>
|
|
<span class="c"> * If a whitelist is provided, only matching object keys will be included.</span>
|
|
<span class="c"> * If a depth limit is provided, objects and arrays at that depth will</span>
|
|
<span class="c"> * be stringified as empty.</span>
|
|
<span class="c"> * @method stringify</span>
|
|
<span class="c"> * @param o {MIXED} any arbitrary object to convert to JSON string</span>
|
|
<span class="c"> * @param w {Array} (optional) whitelist of acceptable object keys to include</span>
|
|
<span class="c"> * @param d {number} (optional) depth limit to recurse objects/arrays (practical minimum 1)</span>
|
|
<span class="c"> * @return {string} JSON string representation of the input</span>
|
|
<span class="c"> * @static</span>
|
|
<span class="c"> * @public</span>
|
|
<span class="c"> */</span>
|
|
<span class="nx">stringify</span> <span class="o">:</span> <span class="k">function</span> <span class="o">(</span><span class="nx">o</span><span class="o">,</span><span class="nx">w</span><span class="o">,</span><span class="nx">d</span><span class="o">)</span> <span class="o">{</span>
|
|
|
|
<span class="k">var</span> <span class="nx">l</span> <span class="o">=</span> <span class="nx">YAHOO</span><span class="o">.</span><span class="nx">lang</span><span class="o">,</span>
|
|
<span class="nx">J</span> <span class="o">=</span> <span class="nx">l</span><span class="o">.</span><span class="nx">JSON</span><span class="o">,</span>
|
|
<span class="nx">m</span> <span class="o">=</span> <span class="nx">J</span><span class="o">.</span><span class="nx">_CHARS</span><span class="o">,</span>
|
|
<span class="nx">str_re</span> <span class="o">=</span> <span class="k">this</span><span class="o">.</span><span class="nx">_SPECIAL_CHARS</span><span class="o">,</span>
|
|
<span class="nx">pstack</span> <span class="o">=</span> <span class="o">[];</span> <span class="c">// Processing stack used for cyclical ref protection</span>
|
|
<span class="c"></span>
|
|
<span class="c">// escape encode special characters</span>
|
|
<span class="c"></span> <span class="k">var</span> <span class="nx">_char</span> <span class="o">=</span> <span class="k">function</span> <span class="o">(</span><span class="nx">c</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(!</span><span class="nx">m</span><span class="o">[</span><span class="nx">c</span><span class="o">])</span> <span class="o">{</span>
|
|
<span class="k">var</span> <span class="nx">a</span> <span class="o">=</span> <span class="nx">c</span><span class="o">.</span><span class="nx">charCodeAt</span><span class="o">();</span>
|
|
<span class="nx">m</span><span class="o">[</span><span class="nx">c</span><span class="o">]</span> <span class="o">=</span> <span class="s1">'\\u00'</span> <span class="o">+</span> <span class="nb">Math</span><span class="o">.</span><span class="nx">floor</span><span class="o">(</span><span class="nx">a</span> <span class="o">/</span> <span class="m">16</span><span class="o">).</span><span class="nx">toString</span><span class="o">(</span><span class="m">16</span><span class="o">)</span> <span class="o">+</span>
|
|
<span class="o">(</span><span class="nx">a</span> <span class="o">%</span> <span class="m">16</span><span class="o">).</span><span class="nx">toString</span><span class="o">(</span><span class="m">16</span><span class="o">);</span>
|
|
<span class="o">}</span>
|
|
<span class="k">return</span> <span class="nx">m</span><span class="o">[</span><span class="nx">c</span><span class="o">];</span>
|
|
<span class="o">};</span>
|
|
|
|
<span class="c">// Enclose the escaped string in double quotes</span>
|
|
<span class="c"></span> <span class="k">var</span> <span class="nx">_string</span> <span class="o">=</span> <span class="k">function</span> <span class="o">(</span><span class="nx">s</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="s1">'"'</span> <span class="o">+</span> <span class="nx">s</span><span class="o">.</span><span class="nx">replace</span><span class="o">(</span><span class="nx">str_re</span><span class="o">,</span> <span class="nx">_char</span><span class="o">)</span> <span class="o">+</span> <span class="s1">'"'</span><span class="o">;</span>
|
|
<span class="o">};</span>
|
|
|
|
<span class="c">// Use the configured date conversion</span>
|
|
<span class="c"></span> <span class="k">var</span> <span class="nx">_date</span> <span class="o">=</span> <span class="nx">J</span><span class="o">.</span><span class="nx">dateToString</span><span class="o">;</span>
|
|
|
|
<span class="c">// Worker function. Fork behavior on data type and recurse objects and</span>
|
|
<span class="c"></span> <span class="c">// arrays per the configured depth.</span>
|
|
<span class="c"></span> <span class="k">var</span> <span class="nx">_stringify</span> <span class="o">=</span> <span class="k">function</span> <span class="o">(</span><span class="nx">o</span><span class="o">,</span><span class="nx">w</span><span class="o">,</span><span class="nx">d</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">var</span> <span class="nx">t</span> <span class="o">=</span> <span class="k">typeof</span> <span class="nx">o</span><span class="o">,</span>
|
|
<span class="nx">i</span><span class="o">,</span><span class="nx">len</span><span class="o">,</span><span class="nx">j</span><span class="o">,</span> <span class="c">// array iteration</span>
|
|
<span class="c"></span> <span class="nx">k</span><span class="o">,</span><span class="nx">v</span><span class="o">,</span> <span class="c">// object iteration</span>
|
|
<span class="c"></span> <span class="nx">vt</span><span class="o">,</span> <span class="c">// typeof v during iteration</span>
|
|
<span class="c"></span> <span class="nx">a</span><span class="o">;</span> <span class="c">// composition array for performance over string concat</span>
|
|
<span class="c"></span>
|
|
<span class="c">// String</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">t</span> <span class="o">===</span> <span class="s1">'string'</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="nx">_string</span><span class="o">(</span><span class="nx">o</span><span class="o">);</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// native boolean and Boolean instance</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">t</span> <span class="o">===</span> <span class="s1">'boolean'</span> <span class="o">||</span> <span class="nx">o</span> <span class="k">instanceof</span> <span class="nb">Boolean</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="nb">String</span><span class="o">(</span><span class="nx">o</span><span class="o">);</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// native number and Number instance</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">t</span> <span class="o">===</span> <span class="s1">'number'</span> <span class="o">||</span> <span class="nx">o</span> <span class="k">instanceof</span> <span class="nb">Number</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="nb">isFinite</span><span class="o">(</span><span class="nx">o</span><span class="o">)</span> <span class="o">?</span> <span class="nb">String</span><span class="o">(</span><span class="nx">o</span><span class="o">)</span> <span class="o">:</span> <span class="s1">'null'</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Date</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">o</span> <span class="k">instanceof</span> <span class="nb">Date</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="nx">_date</span><span class="o">(</span><span class="nx">o</span><span class="o">);</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Array</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">l</span><span class="o">.</span><span class="nx">isArray</span><span class="o">(</span><span class="nx">o</span><span class="o">))</span> <span class="o">{</span>
|
|
<span class="c">// Check for cyclical references</span>
|
|
<span class="c"></span> <span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="o">=</span> <span class="nx">pstack</span><span class="o">.</span><span class="nx">length</span> <span class="o">-</span> <span class="m">1</span><span class="o">;</span> <span class="nx">i</span> <span class="o">>=</span> <span class="m">0</span><span class="o">;</span> <span class="o">--</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">pstack</span><span class="o">[</span><span class="nx">i</span><span class="o">]</span> <span class="o">===</span> <span class="nx">o</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="s1">'null'</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Add the array to the processing stack</span>
|
|
<span class="c"></span> <span class="nx">pstack</span><span class="o">[</span><span class="nx">pstack</span><span class="o">.</span><span class="nx">length</span><span class="o">]</span> <span class="o">=</span> <span class="nx">o</span><span class="o">;</span>
|
|
|
|
<span class="nx">a</span> <span class="o">=</span> <span class="o">[];</span>
|
|
<span class="c">// Only recurse if we're above depth config</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">d</span> <span class="o">></span> <span class="m">0</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="o">=</span> <span class="nx">o</span><span class="o">.</span><span class="nx">length</span> <span class="o">-</span> <span class="m">1</span><span class="o">;</span> <span class="nx">i</span> <span class="o">>=</span> <span class="m">0</span><span class="o">;</span> <span class="o">--</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="nx">a</span><span class="o">[</span><span class="nx">i</span><span class="o">]</span> <span class="o">=</span> <span class="nx">_stringify</span><span class="o">(</span><span class="nx">o</span><span class="o">[</span><span class="nx">i</span><span class="o">],</span><span class="nx">w</span><span class="o">,</span><span class="nx">d</span><span class="o">-</span><span class="m">1</span><span class="o">)</span> <span class="o">||</span> <span class="s1">'null'</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// remove the array from the stack</span>
|
|
<span class="c"></span> <span class="nx">pstack</span><span class="o">.</span><span class="nx">pop</span><span class="o">();</span>
|
|
|
|
<span class="k">return</span> <span class="s1">'['</span> <span class="o">+</span> <span class="nx">a</span><span class="o">.</span><span class="nx">join</span><span class="o">(</span><span class="s1">','</span><span class="o">)</span> <span class="o">+</span> <span class="s1">']'</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Object</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">t</span> <span class="o">===</span> <span class="s1">'object'</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="c">// Test for null reporting as typeof 'object'</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(!</span><span class="nx">o</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="s1">'null'</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Check for cyclical references</span>
|
|
<span class="c"></span> <span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="o">=</span> <span class="nx">pstack</span><span class="o">.</span><span class="nx">length</span> <span class="o">-</span> <span class="m">1</span><span class="o">;</span> <span class="nx">i</span> <span class="o">>=</span> <span class="m">0</span><span class="o">;</span> <span class="o">--</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">pstack</span><span class="o">[</span><span class="nx">i</span><span class="o">]</span> <span class="o">===</span> <span class="nx">o</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">return</span> <span class="s1">'null'</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Add the object to the processing stack</span>
|
|
<span class="c"></span> <span class="nx">pstack</span><span class="o">[</span><span class="nx">pstack</span><span class="o">.</span><span class="nx">length</span><span class="o">]</span> <span class="o">=</span> <span class="nx">o</span><span class="o">;</span>
|
|
|
|
<span class="nx">a</span> <span class="o">=</span> <span class="o">[];</span>
|
|
<span class="c">// Only recurse if we're above depth config</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">d</span> <span class="o">></span> <span class="m">0</span><span class="o">)</span> <span class="o">{</span>
|
|
|
|
<span class="c">// If whitelist provided, take only those keys</span>
|
|
<span class="c"></span> <span class="k">if</span> <span class="o">(</span><span class="nx">w</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">for</span> <span class="o">(</span><span class="nx">i</span> <span class="o">=</span> <span class="m">0</span><span class="o">,</span> <span class="nx">j</span> <span class="o">=</span> <span class="m">0</span><span class="o">,</span> <span class="nx">len</span> <span class="o">=</span> <span class="nx">w</span><span class="o">.</span><span class="nx">length</span><span class="o">;</span> <span class="nx">i</span> <span class="o"><</span> <span class="nx">len</span><span class="o">;</span> <span class="o">++</span><span class="nx">i</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="k">typeof</span> <span class="nx">w</span><span class="o">[</span><span class="nx">i</span><span class="o">]</span> <span class="o">===</span> <span class="s1">'string'</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="nx">v</span> <span class="o">=</span> <span class="nx">_stringify</span><span class="o">(</span><span class="nx">o</span><span class="o">[</span><span class="nx">w</span><span class="o">[</span><span class="nx">i</span><span class="o">]],</span><span class="nx">w</span><span class="o">,</span><span class="nx">d</span><span class="o">-</span><span class="m">1</span><span class="o">);</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">v</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="nx">a</span><span class="o">[</span><span class="nx">j</span><span class="o">++]</span> <span class="o">=</span> <span class="nx">_string</span><span class="o">(</span><span class="nx">w</span><span class="o">[</span><span class="nx">i</span><span class="o">])</span> <span class="o">+</span> <span class="s1">':'</span> <span class="o">+</span> <span class="nx">v</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Otherwise, take all valid object properties</span>
|
|
<span class="c"></span> <span class="c">// omitting the prototype chain properties</span>
|
|
<span class="c"></span> <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
|
|
<span class="nx">j</span> <span class="o">=</span> <span class="m">0</span><span class="o">;</span>
|
|
<span class="k">for</span> <span class="o">(</span><span class="nx">k</span> <span class="k">in</span> <span class="nx">o</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="k">typeof</span> <span class="nx">k</span> <span class="o">===</span> <span class="s1">'string'</span> <span class="o">&&</span> <span class="nx">l</span><span class="o">.</span><span class="nx">hasOwnProperty</span><span class="o">(</span><span class="nx">o</span><span class="o">,</span><span class="nx">k</span><span class="o">))</span> <span class="o">{</span>
|
|
<span class="nx">v</span> <span class="o">=</span> <span class="nx">_stringify</span><span class="o">(</span><span class="nx">o</span><span class="o">[</span><span class="nx">k</span><span class="o">],</span><span class="nx">w</span><span class="o">,</span><span class="nx">d</span><span class="o">-</span><span class="m">1</span><span class="o">);</span>
|
|
<span class="k">if</span> <span class="o">(</span><span class="nx">v</span><span class="o">)</span> <span class="o">{</span>
|
|
<span class="nx">a</span><span class="o">[</span><span class="nx">j</span><span class="o">++]</span> <span class="o">=</span> <span class="nx">_string</span><span class="o">(</span><span class="nx">k</span><span class="o">)</span> <span class="o">+</span> <span class="s1">':'</span> <span class="o">+</span> <span class="nx">v</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="c">// Remove the object from processing stack</span>
|
|
<span class="c"></span> <span class="nx">pstack</span><span class="o">.</span><span class="nx">pop</span><span class="o">();</span>
|
|
|
|
<span class="k">return</span> <span class="s1">'{'</span> <span class="o">+</span> <span class="nx">a</span><span class="o">.</span><span class="nx">join</span><span class="o">(</span><span class="s1">','</span><span class="o">)</span> <span class="o">+</span> <span class="s1">'}'</span><span class="o">;</span>
|
|
<span class="o">}</span>
|
|
|
|
<span class="k">return</span> <span class="kc">undefined</span><span class="o">;</span> <span class="c">// invalid input</span>
|
|
<span class="c"></span> <span class="o">};</span>
|
|
|
|
<span class="c">// Default depth to POSITIVE_INFINITY</span>
|
|
<span class="c"></span> <span class="nx">d</span> <span class="o">=</span> <span class="nx">d</span> <span class="o">>=</span> <span class="m">0</span> <span class="o">?</span> <span class="nx">d</span> <span class="o">:</span> <span class="m">1</span><span class="o">/</span><span class="m">0</span><span class="o">;</span>
|
|
|
|
<span class="c">// process the input</span>
|
|
<span class="c"></span> <span class="k">return</span> <span class="nx">_stringify</span><span class="o">(</span><span class="nx">o</span><span class="o">,</span><span class="nx">w</span><span class="o">,</span><span class="nx">d</span><span class="o">);</span>
|
|
<span class="o">}</span>
|
|
<span class="o">};</span>
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="yui-b">
|
|
<div class="nav">
|
|
|
|
<div class="module">
|
|
<h4>Modules</h4>
|
|
<ul class="content">
|
|
|
|
<li class=""><a href="module_animation.html">animation</a></li>
|
|
|
|
<li class=""><a href="module_autocomplete.html">autocomplete</a></li>
|
|
|
|
<li class=""><a href="module_button.html">button</a></li>
|
|
|
|
<li class=""><a href="module_calendar.html">calendar</a></li>
|
|
|
|
<li class=""><a href="module_charts.html">charts</a></li>
|
|
|
|
<li class=""><a href="module_colorpicker.html">colorpicker</a></li>
|
|
|
|
<li class=""><a href="module_connection.html">connection</a></li>
|
|
|
|
<li class=""><a href="module_container.html">container</a></li>
|
|
|
|
<li class=""><a href="module_cookie.html">cookie</a></li>
|
|
|
|
<li class=""><a href="module_datasource.html">datasource</a></li>
|
|
|
|
<li class=""><a href="module_datatable.html">datatable</a></li>
|
|
|
|
<li class=""><a href="module_dom.html">dom</a></li>
|
|
|
|
<li class=""><a href="module_dragdrop.html">dragdrop</a></li>
|
|
|
|
<li class=""><a href="module_editor.html">editor</a></li>
|
|
|
|
<li class=""><a href="module_element.html">element</a></li>
|
|
|
|
<li class=""><a href="module_event.html">event</a></li>
|
|
|
|
<li class=""><a href="module_get.html">get</a></li>
|
|
|
|
<li class=""><a href="module_history.html">history</a></li>
|
|
|
|
<li class=""><a href="module_imagecropper.html">imagecropper</a></li>
|
|
|
|
<li class=""><a href="module_imageloader.html">imageloader</a></li>
|
|
|
|
<li class="selected"><a href="module_json.html">json</a></li>
|
|
|
|
<li class=""><a href="module_layout.html">layout</a></li>
|
|
|
|
<li class=""><a href="module_logger.html">logger</a></li>
|
|
|
|
<li class=""><a href="module_menu.html">menu</a></li>
|
|
|
|
<li class=""><a href="module_profiler.html">profiler</a></li>
|
|
|
|
<li class=""><a href="module_profilerviewer.html">profilerviewer</a></li>
|
|
|
|
<li class=""><a href="module_resize.html">resize</a></li>
|
|
|
|
<li class=""><a href="module_selector.html">selector</a></li>
|
|
|
|
<li class=""><a href="module_slider.html">slider</a></li>
|
|
|
|
<li class=""><a href="module_tabview.html">tabview</a></li>
|
|
|
|
<li class=""><a href="module_treeview.html">treeview</a></li>
|
|
|
|
<li class=""><a href="module_uploader.html">uploader</a></li>
|
|
|
|
<li class=""><a href="module_yahoo.html">yahoo</a></li>
|
|
|
|
<li class=""><a href="module_yuiloader.html">yuiloader</a></li>
|
|
|
|
<li class=""><a href="module_yuitest.html">yuitest</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="module">
|
|
<h4>Classes</h4>
|
|
<ul class="content">
|
|
<li class=""><a href="YAHOO.lang.JSON.html">YAHOO.lang.JSON</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<div class="module">
|
|
<h4>Files</h4>
|
|
<ul class="content">
|
|
<li class="selected"><a href="JSON.js.html">JSON.js</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="ft">
|
|
<hr />
|
|
Copyright © 2007 Yahoo! Inc. All rights reserved.
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|