在线 JSON 格式化
https://github.com/jsonhero-io/jsonhero-web
JSONPath 在线查询工具
文章
什么是 JSON ?
JSON 指的是 JavaScript 对象表示法(JavaScript Object Notation),一种轻量级的文本数据交换格式,是存储和交换文本信息的语法。类似 XML。
JSON 独立于语言:JSON 使用 Javascript语法来描述数据对象,但是 JSON 仍然独立于语言和平台。JSON 解析器和JSON 库支持许多不同的编程语言。 目前非常多的动态(PHP,JSP,.NET)编程语言都支持JSON。
JSON 具有自我描述性,更易理解,比 XML 更小、更快,更易解析。
{
"sites": [
{ "name":"test" , "url":"www.test.com" },
{ "name":"google" , "url":"www.google.com" },
{ "name":"微博" , "url":"www.weibo.com" }
]
}
这个 sites 对象是包含 3 个站点记录(对象)的数组。
JSON 文本格式在语法上与创建 JavaScript 对象的代码相同。
由于这种相似性,无需解析器,JavaScript 程序能够使用内建的 eval()
函数,用 JSON 数据来生成原生的 JavaScript 对象。
JSON 文件的文件类型是 ".json"
JSON 文本的 MIME 类型是 "application/json"
与 XML 对比
与 XML 不同之处
XML 需要使用 XML 解析器来解析,JSON 可以使用标准的 JavaScript 函数来解析。
语法
JSON 语法是 JavaScript 语法的子集。
JSON 名称/值对
JSON 数据的书写格式是:名称/值对。
名称/值对包括字段名称(在双引号中),后面写一个冒号,然后是值:
这很容易理解,等价于这条 JavaScript 语句:
JSON 值
JSON 值可以是:
JSON 数字
JSON 数字可以是整型或者浮点型:
JSON 对象
JSON 对象在大括号 {}
中书写:
对象可以包含多个名称/值对:
{ "name":"test" , "url":"www.test.com" }
这一点也容易理解,与这条 JavaScript 语句等价:
name = "test"
url = "www.test.com"
JSON 数组
JSON 数组在中括号中书写:
数组可包含多个对象:
{
"sites": [
{ "name":"test" , "url":"www.test.com" },
{ "name":"google" , "url":"www.google.com" },
{ "name":"微博" , "url":"www.weibo.com" }
]
}
在上面的例子中,对象 "sites" 是包含三个对象的数组。每个对象代表一条关于某个网站(name、url)的记录。
JSON 布尔值
JSON 布尔值可以是 true 或者 false:
JSON null
JSON 可以设置 null 值:
JSON 使用 JavaScript 语法
因为 JSON 使用 JavaScript 语法,所以无需额外的软件就能处理 JavaScript 中的 JSON。
通过 JavaScript,你可以创建一个对象数组,并像这样进行赋值:
var sites = [
{ "name":"test" , "url":"www.test.com" },
{ "name":"google" , "url":"www.google.com" },
{ "name":"微博" , "url":"www.weibo.com" }
];
可以像这样访问 JavaScript 对象数组中的第一项(索引从 0 开始):
返回的内容是:
可以像这样修改数据:
sites[0].name="test";
对象
对象语法
{ "name":"test", "alexa":10000, "site":null }
JSON 对象使用在大括号 {}
中书写。
对象可以包含多个 key/value(键/值)对。
key 必须是字符串,value 可以是合法的 JSON 数据类型(字符串, 数字, 对象, 数组, 布尔值或 null)。
key 和 value 中使用冒号 :
分割。
每个 key/value 对使用逗号 ,
分割。
访问对象值
你可以使用点号 .
来访问对象的值:
<p id="demo"></p>
<script>
var myObj, x;
myObj = { "name":"test", "alexa":10000, "site":null };
x = myObj.name;
document.getElementById("demo").innerHTML = x;
</script>
你也可以使用中括号 []
来访问对象的值:
var myObj, x;
myObj = { "name":"test", "alexa":10000, "site":null };
x = myObj["name"];
循环对象
你可以使用 for-in 来循环对象的属性:
<p id="demo"></p>
<script>
var myObj = { "name":"test", "alexa":10000, "site":null };
for (x in myObj) {
document.getElementById("demo").innerHTML += x + "<br>";
}
</script>
在 for-in 循环对象的属性时,使用中括号 []
来访问属性的值:
var myObj = { "name":"test", "alexa":10000, "site":null };
for (x in myObj) {
document.getElementById("demo").innerHTML += myObj[x] + "<br>";
}
嵌套 JSON 对象
JSON 对象中可以包含另外一个 JSON 对象:
myObj = {
"name":"test",
"alexa":10000,
"sites": {
"site1":"www.test.com",
"site2":"m.test.com",
"site3":"c.test.com"
}
}
你可以使用点号 .
或者中括号 []
来访问嵌套的 JSON 对象。
<p id="demo"></p>
<script>
myObj = {
"name":"test",
"alexa":10000,
"sites": {
"site1":"www.test.com",
"site2":"m.test.com",
"site3":"c.test.com"
}
}
document.getElementById("demo").innerHTML += myObj.sites.site1 + "<br>";
// 或者
document.getElementById("demo").innerHTML += myObj.sites["site1"];
</script>
修改值
你可以使用点号 .
来修改 JSON 对象的值:
<p id="demo"></p>
<script>
var myObj, i, x = "";
myObj = {
"name":"test",
"alexa":10000,
"sites": {
"site1":"www.test.com",
"site2":"m.test.com",
"site3":"c.test.com"
}
}
myObj.sites.site1 = "www.google.com";
for (i in myObj.sites) {
x += myObj.sites[i] + "<br>";
}
document.getElementById("demo").innerHTML = x;
</script>
你可以使用中括号 []
来修改 JSON 对象的值:
myObj.sites["site1"] = "www.google.com";
删除对象属性
我们可以使用 delete 关键字来删除 JSON 对象的属性:
<p id="demo"></p>
<script>
var myObj, i, x = "";
myObj = {
"name":"test",
"alexa":10000,
"sites": {
"site1":"www.test.com",
"site2":"m.test.com",
"site3":"c.test.com"
}
}
delete myObj.sites.site1;
for (i in myObj.sites) {
x += myObj.sites[i] + "<br>";
}
document.getElementById("demo").innerHTML = x;
</script>
你可以使用中括号 []
来删除 JSON 对象的属性:
delete myObj.sites["site1"]
JSON.parse()
JSON 通常用于与服务端交换数据。
在接收服务器数据时一般是字符串。
我们可以使用 JSON.parse()
方法将数据转换为 JavaScript 对象。
JSON.parse(text[, reviver])
reviver: 可选,一个转换结果的函数, 将为对象的每个成员调用此函数。
JSON 解析实例
例如我们从服务器接收了以下数据:
{
"name":"test",
"alexa":10000,
"site":"www.test.com"
}
我们使用 JSON.parse()
方法处理以上数据,将其转换为 JavaScript 对象:
var obj = JSON.parse('{ "name":"test", "alexa":10000, "site":"www.test.com" }');
解析完成后,我们就可以在网页上使用 JSON 数据了:
<p id="demo"></p>
<script>
var obj = JSON.parse('{ "name":"test", "alexa":10000, "site":"www.test.com" }');
document.getElementById("demo").innerHTML = obj.name + ":" + obj.site;
</script>
从服务端接收 JSON 数据
我们可以使用 AJAX 从服务器请求 JSON 数据,并解析为 JavaScript 对象。
<p id="demo"></p>
<script>
var xmlhttp = new XMLHttpRequest();
xmlhttp.onreadystatechange = function() {
if (this.readyState == 4 && this.status == 200) {
myObj = JSON.parse(this.responseText);
document.getElementById("demo").innerHTML = myObj.name;
}
};
xmlhttp.open("GET", "/ajax/json_demo.txt", true);
xmlhttp.send();
</script>
<p>查看 JSON 文件数据 <a href="/ajax/json_demo.txt" target="_blank">json_demo.txt</a></p>
json_demo.txt
从服务端接收数组的 JSON 数据
如果从服务端接收的是数组的 JSON 数据,则 JSON.parse
会将其转换为 JavaScript 数组:
<p id="demo"></p>
<script>
var xmlhttp = new XMLHttpRequest();
xmlhttp.onreadystatechange = function() {
if (this.readyState == 4 && this.status == 200) {
myArr = JSON.parse(this.responseText);
document.getElementById("demo").innerHTML = myArr[1];
}
};
xmlhttp.open("GET", "/ajax/json_demo_array.txt", true);
xmlhttp.send();
</script>
<p>查看服务端数据 <a href="/ajax/json_demo_array.txt" target="_blank">json_demo_array.txt</a></p>
json_demo_array.txt
[ "Google", "test", "Taobao" ]
异常
JSON 不能存储 Date 对象。
如果你需要存储 Date 对象,需要将其转换为字符串。
之后再将字符串转换为 Date 对象。
<p id="demo"></p>
<script>
var text = '{ "name":"test", "initDate":"2013-12-14", "site":"www.test.com"}';
var obj = JSON.parse(text);
obj.initDate = new Date(obj.initDate);
document.getElementById("demo").innerHTML = obj.name + "创建日期: " + obj.initDate;
</script>
我们可以启用 JSON.parse
的第二个参数 reviver,一个转换结果的函数,对象的每个成员调用此函数。
<p id="demo"></p>
<script>
var text = '{ "name":"test", "initDate":"2013-12-14", "site":"www.test.com"}';
var obj = JSON.parse(text, function (key, value) {
if (key == "initDate") {
return new Date(value);
} else {
return value;
}});
document.getElementById("demo").innerHTML = obj.name + "创建日期:" + obj.initDate;
</script>
解析函数
JSON 不允许包含函数,但你可以将函数作为字符串存储,之后再将字符串转换为函数。
<p id="demo"></p>
<script>
var text = '{ "name":"test", "alexa":"function () {return 10000;}", "site":"www.test.com"}';
var obj = JSON.parse(text);
obj.alexa = eval("(" + obj.alexa + ")");
document.getElementById("demo").innerHTML = obj.name + " Alexa 排名:" + obj.alexa();
</script>
不建议在 JSON 中使用函数。
JSON.stringify()
JSON 通常用于与服务端交换数据。
在向服务器发送数据时一般是字符串。
我们可以使用 JSON.stringify()
方法将 JavaScript 对象转换为字符串。
JSON.stringify(value[, replacer[, space]])
参数说明:
value : 必需, 要转换的 JavaScript 值(通常为对象或数组)。
replacer : 可选。用于转换结果的函数或数组。
如果 replacer 为函数,则 JSON.stringify 将调用该函数,并传入每个成员的键和值。使用返回值而不是原始值。如果此函数返回 undefined,则排除成员。根对象的键是一个空字符串:""。
如果 replacer 是一个数组,则仅转换该数组中具有键值的成员。成员的转换顺序与键在数组中的顺序一样。当 value 参数也为数组时,将忽略 replacer 数组。
space : 可选,文本添加缩进、空格和换行符,如果 space 是一个数字,则返回值文本在每个级别缩进指定数目的空格,如果 space 大于 10,则文本缩进 10 个空格。space 也可以使用非数字,如:\t。
对象转换
例如我们向服务器发送以下数据:
var obj = { "name":"test", "alexa":10000, "site":"www.test.com"};
我们使用 JSON.stringify()
方法处理以上数据,将其转换为字符串:
var myJSON = JSON.stringify(obj);
myJSON 为字符串。
我们可以将 myJSON 发送到服务器:
<p id="demo"></p>
<script>
var obj = { "name":"test", "alexa":10000, "site":"www.test.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;
</script>
数组转换
我们也可以将 JavaScript 数组转换为 JSON 字符串:
var arr = [ "Google", "test", "Taobao", "Facebook" ];
var myJSON = JSON.stringify(arr);
myJSON 为字符串。
我们可以将 myJSON 发送到服务器:
<p id="demo"></p>
<script>
var arr = [ "Google", "test", "Taobao", "Facebook" ];
var myJSON = JSON.stringify(arr);
document.getElementById("demo").innerHTML = myJSON;
</script>
异常
JSON 不能存储 Date 对象。
JSON.stringify()
会将所有日期转换为字符串。
<p id="demo"></p>
<script>
var obj = { "name":"test", "initDate":new Date(), "site":"www.test.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;
</script>
之后你可以再将字符串转换为 Date 对象。
解析函数
JSON 不允许包含函数,JSON.stringify()
会删除 JavaScript 对象的函数,包括 key 和 value。
<p id="demo"></p>
<script>
var obj = { "name":"test", "alexa":function () {return 10000;}, "site":"www.test.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;
</script>
我们可以在执行 JSON.stringify()
函数前将函数转换为字符串来避免以上问题的发生:
<p id="demo"></p>
<script>
var obj = { "name":"test", "alexa":function () {return 10000;}, "site":"www.test.com"};
obj.alexa = obj.alexa.toString();
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;
</script>
不建议在 JSON 中使用函数。
JSON 使用
JSON 最常见的用法之一,是从 web 服务器上读取 JSON 数据(作为文件或作为 HttpRequest),将 JSON 数据转换为 JavaScript 对象,然后在网页中使用该数据。
JSON 实例 - 来自字符串的对象
创建包含 JSON 语法的 JavaScript 字符串:
var txt = '{ "sites" : [' +
'{ "name":"test" , "url":"www.test.com" },' +
'{ "name":"google" , "url":"www.google.com" },' +
'{ "name":"微博" , "url":"www.weibo.com" } ]}';
由于 JSON 语法是 JavaScript 语法的子集,JavaScript 函数 eval()
可用于将 JSON 文本转换为 JavaScript 对象。
eval()
函数使用的是 JavaScript 编译器,可解析 JSON 文本,然后生成 JavaScript 对象。必须把文本包围在括号中,这样才能避免语法错误:
var obj = eval ("(" + txt + ")");
在网页中使用 JavaScript 对象:
<p>
网站名: <span id="name"></span><br>
网站地址: <span id="url"></span><br>
</p>
<script>
var txt = '{ "sites" : [' +
'{ "name":"test" , "url":"www.test.com" },' +
'{ "name":"google" , "url":"www.google.com" },' +
'{ "name":"微博" , "url":"www.weibo.com" } ]}';
var obj = eval ("(" + txt + ")");
document.getElementById("name").innerHTML=obj.sites[0].name
document.getElementById("url").innerHTML=obj.sites[0].url
</script>
JSON 解析器
eval()
函数可编译并执行任何 JavaScript 代码。这隐藏了一个潜在的安全问题。
使用 JSON 解析器将 JSON 转换为 JavaScript 对象是更安全的做法。JSON 解析器只能识别 JSON 文本,而不会编译脚本。
在浏览器中,这提供了原生的 JSON 支持,而且 JSON 解析器的速度更快。
较新的浏览器和最新的 ECMAScript (JavaScript) 标准中均包含了原生的对 JSON 的支持。
jsonl
jsonlines
https://jsonlines.org/examples/
Source & Reference