首页 > 代码库 > JSON3-翻译(不当之处,请指正)
JSON3-翻译(不当之处,请指正)
http://bestiejs.github.io/json3/
JSON 3 显示了两个功能:stringify():序列化一个javaScript值为一个JSON,和parse():将一个json字符串转换成一个JavaScript对象.这是对JSON2的一个嵌入式替换.这个函数完全遵照ECMAScript的规范描述.除了日期的序列化差异.JSON3没有使用eval和正则表达式.这里在过时和移动的环境里提供了很好的安全性和性能优势.
对比JSON2 发生的改变:
json3...
1.正确的序列化原始包装对象。
2.序列化环状结构时,抛出一个TypeError(JSON2直到递归调用堆栈溢出)
3.利用功能测试,检测损坏的或不完整的原生JSON实现(JSON2只检查的本地函数的存在).测试只在运行时执行一次,所以有分析或序列化值时,没有额外的性能开销。
相反,对比JSON2,JSON3没有的是...
1.给Boolean, Number, and String 原型添加toJSON()方法.这些都不是任何标准的一部分,并且使 stringify()的设计实现变的多余.
2.给 Date.prototype添加toJSON() or toISOString()方法.具体查下下面的日期.
Date 序列化:
1.JSON3偏离规范的重要途径之一:它并没有定义Date#toISOString() 或者 Date#toJSON()方法.这里保留了一般JS的兼容性,同时避免了污染本来的原型(prototypes).相反的,date序列化是有stringify()实现内部执行的.如果一个date对象没有定义传统的toJSON()方法,它被序列化为一个简单iso 8601 日期字符串.
2.几个本地的Date#toJSON()方法生成日期时间字符串在规范上并不符合语法:例如,Safari4的所有版本以及JSON2,不能正确序列扩展的年.另外,JSON2和旧的实现省略了日期时间字符串毫秒.(在ES 5中是可选择的,在5.1中是必须要求的.)最后在 Safari 4和5的所有版本中,序列化一个无效的日期会产生一个"Invalid Date",而不是null;因为这些环境显示出其他序列化的错误,但是,JSON3将覆盖本地字符串化()实现。
使用:
页面展示:
<script src="http://cdnjs.cloudflare.com/ajax/libs/json3/3.3.2/json3.min.js"></script><script> JSON.stringify({"Hello": 123}); // => ‘{"Hello":123}‘ JSON.parse("[[1, 2, 3], 1, 2, 3, 4]", function (key, value) { if (typeof value =http://www.mamicode.com/="number") { value = http://www.mamicode.com/value % 2 ?"Odd" : "Even"; } return value; }); // => [["Odd", "Even", "Odd"], "Odd", "Even", "Odd", "Even"]</script>
当在web浏览器中使用时,JSON3公开了一个额外的JSON3对象包含noConfict()和renlnContext()函数,以及别名以stringify()和parse()函数.
noConfict()和renlnContext()函数:
.JSON3.noConflict() 还原全局JSON对象的原始值,返回一个引用JSON3对象
.JSON3.runInContext([context, exports])使用给定上下文对象初始化JSON3,(e.g., window, global, etc.), 或全局对象,如果忽略.如果指定了出口对象,stringify(), parse(), 和 runInContext() 函数将会附着它来代替一个新的对象.
异步模块装载机:
JSON3 被定义为一个匿名模块兼容RequireJS.js,curl.js和其他异步模块加载机.
<script src="http://cdnjs.cloudflare.com/ajax/libs/require.js/2.1.10/require.js"></script><script> require({ "paths": { "json3": "./path/to/json3" } }, ["json3"], function (JSON) { JSON.parse("[1, 2, 3]"); // => [1, 2, 3] });</script>
为了避免与第三方脚本的问题,JSON3导出到全局范围,即使在模块加载器中使用.如果这种行为是不希望的,JSON3.noConflict()可用于全局JSON对象恢复到其原始值。
注:如果您打算使用JSON3旁边另一个模块,请不要简单地串连这些模块组合在一起,因为这将导致一个脚本重复定义调用,导致AMD装载机的错误。如果你需要为生产环境压缩文件,那么可以使用r.js来处理优化.
CommonJS 环境:
var JSON3 = require("./path/to/json3");
JSON3.parse("[1, 2, 3]");
// => [1, 2, 3]
JavaScript 引擎:
load("path/to/json3.js");
JSON.stringify({"Hello": 123, "Good-bye": 456}, ["Hello"], "\t");
// => ‘{\n\t"Hello": 123\n}‘
兼容性:
JSON3已经在web浏览器,CommonJS环境和JavaScript引擎.
Web浏览器:
1.IE6.0或者更高版本
2.火狐1.0版本或者更高
3.Safari2.0版本或者更高
4.Opera7.02版本或者更高
5.Mozilia1.0,Netscape6.2.3,SeaMonkey1.0或者更高版本.
CommonJS环境:
1.Node0.2.6或者更高版本
2.RinqoJS0.4或者更高版本
3.Narwhal0.3.2或者更高版本
JavaScript引擎:
1.Mozilia Rhino1.5R5或者更高版本
2.WebKitJSC
3.Google V8
已知的不兼容:
试图序列化参数对象可能会跨环境产生不一致的结果,由于规范版本的差异.作为一种变通方法,请首先转换参数对象到一个数组:JSON.stringify([].slice.call(arguments, 0)).
所需的本地方法:
JSON3假设下面的方法存在,并且和ECMAScript规范中的功能描述一样.
The Number, String, Array, Object, Date, SyntaxError, and TypeError constructors.
String.fromCharCode
Object#toString
Function#call
Math.floor
Number#toString
Date#valueOf
String.prototype: indexOf, charCodeAt, charAt, slice.
Array.prototype: push, pop, join.
JSON3-翻译(不当之处,请指正)