value:
必需, 要转换的 JavaScript 值(通常为对象或数组)。
replacer:
可选。用于转换结果的函数或数组。
如果 replacer 为函数,则 JSON.stringify 将调用该函数,并传入每个成员的键和值。使用返回值而不是原始值。如果此函数返回 undefined,则排除成员。根对象的键是一个空字符串:""。
如果 replacer 是一个数组,则仅转换该数组中具有键值的成员。成员的转换顺序与键在数组中的顺序一样。当 value 参数也为数组时,将忽略 replacer 数组。
space:
可选,文本添加缩进、空格和换行符,如果 space 是一个数字,则返回值文本在每个级别缩进指定数目的空格,如果 space 大于 10,则文本缩进 10 个空格。space 也可以使用非数字,如:\t。
JavaScript 对象转换
例如我们向服务器发送以下数据:
var
obj
=
{
"
name
"
:
"
runoob
"
,
"
alexa
"
:
10000
,
"
site
"
:
"
www.runoob.com
"
}
;
我们使用 JSON.stringify() 方法处理以上数据,将其转换为字符串:
var
myJSON
=
JSON
.
stringify
(
obj
)
;
myJSON 为字符串。
我们可以将 myJSON 发送到服务器:
var
obj
=
{
"
name
"
:
"
runoob
"
,
"
alexa
"
:
10000
,
"
site
"
:
"
www.runoob.com
"
}
;
var
myJSON
=
JSON
.
stringify
(
obj
)
;
document
.
getElementById
(
"
demo
"
)
.
innerHTML
=
myJSON
;
尝试一下 »
JavaScript 数组转换
我们也可以将 JavaScript 数组转换为 JSON 字符串:
var
arr
=
[
"
Google
"
,
"
Runoob
"
,
"
Taobao
"
,
"
Facebook
"
]
;
var
myJSON
=
JSON
.
stringify
(
arr
)
;
myJSON 为字符串。
我们可以将 myJSON 发送到服务器:
var
arr
=
[
"
Google
"
,
"
Runoob
"
,
"
Taobao
"
,
"
Facebook
"
]
;
var
myJSON
=
JSON
.
stringify
(
arr
)
;
document
.
getElementById
(
"
demo
"
)
.
innerHTML
=
myJSON
;
尝试一下 »
var
obj
=
{
"
name
"
:
"
Runoob
"
,
"
initDate
"
:
new
Date
(
)
,
"
site
"
:
"
www.runoob.com
"
}
;
var
myJSON
=
JSON
.
stringify
(
obj
)
;
document
.
getElementById
(
"
demo
"
)
.
innerHTML
=
myJSON
;
尝试一下 »
之后你可以再将字符串转换为 Date 对象。
JSON 不允许包含函数,JSON.stringify() 会删除 JavaScript 对象的函数,包括 key 和 value。
var
obj
=
{
"
name
"
:
"
Runoob
"
,
"
alexa
"
:
function
(
)
{
return
10000
;
}
,
"
site
"
:
"
www.runoob.com
"
}
;
var
myJSON
=
JSON
.
stringify
(
obj
)
;
document
.
getElementById
(
"
demo
"
)
.
innerHTML
=
myJSON
;
尝试一下 »
我们可以在执行 JSON.stringify() 函数前将函数转换为字符串来避免以上问题的发生:
var
obj
=
{
"
name
"
:
"
Runoob
"
,
"
alexa
"
:
function
(
)
{
return
10000
;
}
,
"
site
"
:
"
www.runoob.com
"
}
;
obj
.
alexa
=
obj
.
alexa
.
toString
(
)
;
var
myJSON
=
JSON
.
stringify
(
obj
)
;
document
.
getElementById
(
"
demo
"
)
.
innerHTML
=
myJSON
;
尝试一下 »
不建议在 JSON 中使用函数。
浏览器支持
主流浏览器都支持 JSON.stringify() 函数:
Firefox 3.5
Internet Explorer 8
Chrome
Opera 10
Safari 4