JSON.stringify 函数 (JavaScript)讲解

soゝso 2016-08-22 18:34:55 10764

将 JavaScript 值转换为 JavaScript 对象表示法 (Json) 字符串。


语法

JSON.stringify(value [, replacer] [, space])

参数

 value:必需。 要转换的 JavaScript 值(通常为对象或数组)。
 replacer:可选。 用于转换结果的函数或数组。

 如果 replacer 为函数,则 JSON.stringify 将调用该函数,并传入每个成员的键和值。 使用返回值而不是原始值。 如果此函数返回 undefined,则排除成员。 根对象的键是一个空字符串:""。

 如果 replacer 是一个数组,则仅转换该数组中具有键值的成员。 成员的转换顺序与键在数组中的顺序一样。 当 value 参数也为数组时,将忽略 replacer 数组。

 space:可选。 向返回值 JSON 文本添加缩进、空格和换行符以使其更易于读取。

如果省略 space,则将生成返回值文本,而没有任何额外空格。

如果 space 是一个数字,则返回值文本在每个级别缩进指定数目的空格。 如果 space 大于 10,则文本缩进 10 个空格。

如果 space 是一个非空字符串(例如“\t”),则返回值文本在每个级别中缩进字符串中的字符。

如果 space 是长度大于 10 个字符的字符串,则使用前 10 个字符。


返回值:

一个包含 JSON 文本的字符串。

异常:

Exception Condition。

  1. 替换器参数无效 replacer 参数不是函数或数组。
  2. 值参数中不支持循环引用 value 参数包含循环引用。

如果 value 具有 toJSON 方法,则 JSON.stringify 函数将使用该方法的返回值。 如果 toJSON 方法的返回值为 undefined,则不转换成员。 这使对象能够确定自己的 JSON 表示形式。

将不会转换不具有 JSON 表示形式的值,例如 undefined。 在对象中,将丢弃这些值。 在数组中,会将这些值替换为 null。

字符串值以引号开始和结束。 所有 Unicode 字符可括在引号中,但必须使用反斜杠进行转义的字符除外。 以下字符的前面必须是反斜杠:

  • 引号 (")
  • 反斜杠 (\)
  • 退格键 (b)
  • 换页符 (f)
  • 换行符 (n)
  • 回车符 (r)
  • 水平制表符 (t)
  • 四个十六进制数字 (uhhhh)

执行顺序:

在序列化过程中,如果 value 参数对应有 toJSON 方法,则 JSON.stringify 将首先调用 toJSON 方法。 如果该方法不存在,则使用原始值。 接下来,如果提供 replacer 参数,则该值(原始值或 toJSON 返回值)将替换为 replacer 参数的返回值。 最后,根据可选 space 参数向该值添加空格以生成最终的 JSON 文本。

此示例使用JSON.stringifycontact 对象转换为 JSON 文本。定义 memberfilter 数组以便只转换 surnamephone 成员。省略 firstname成员。

var contact = new Object();
contact.firstname = "Jesper";
contact.surname = "Aaberg";
contact.phone = ["555-0100", "555-0120"];

var memberfilter = new Array();
memberfilter[0] = "surname";
memberfilter[1] = "phone";
var jsonText = JSON.stringify(contact, memberfilter, "\t");
document.write(jsonText);
// Output:
// { "surname": "Aaberg", "phone": [ "555-0100", "555-0120" ] }

此示例将 JSON.stringify 与一个数组一起使用。

replaceToUpper函数将数组中的每个字符串转换为大写形式。

var continents = new Array();
continents[0] = "Europe";
continents[1] = "Asia";
continents[2] = "Australia";
continents[3] = "Antarctica";
continents[4] = "North America";
continents[5] = "South America";
continents[6] = "Africa";

var jsonText = JSON.stringify(continents, replaceToUpper);

function replaceToUpper(key, value) {
    return value.toString().toUpperCase();
}

//Output:
// "EUROPE,ASIA,AUSTRALIA,ANTARCTICA,NORTH AMERICA,SOUTH AMERICA,AFRICA"

此示例使用 toJSON 方法将字符串值转换为大写形式。

var contact = new Object();
contact.firstname = "Jesper";
contact.surname = "Aaberg";
contact.phone = ["555-0100", "555-0120"];

contact.toJSON = function(key)
 {
    var replacement = new Object();
    for (var val in this)
    {
        if (typeof (this[val]) === 'string')
            replacement[val] = this[val].toUpperCase();
        else
            replacement[val] = this[val]
    }
    return replacement;
};

var jsonText = JSON.stringify(contact);
document.write(jsonText);

// Output:
{"firstname":"JESPER","surname":"AABERG","phone":["555-0100","555-0120"]}

'{"firstname":"JESPER","surname":"AABERG","phone":["555-0100","555-0120"]}'

PS:在以上文档模式中受到支持:Internet Explorer 8 标准模式、Internet Explorer 9 标准模式、Internet Explorer 10 标准模式、Internet Explorer 11 标准模式。此外,也在应用商店应用(Windows 8 和 Windows Phone 8.1)中受支持。

版权所属:SO JSON在线解析

原文地址:https://www.sojson.com/blog/25.html

转载时必须以链接形式注明原始出处及本声明。

本文主题:

如果本文对你有帮助,那么请你赞助我,让我更有激情的写下去,帮助更多的人。

关于作者
一个低调而闷骚的男人。
相关文章
JS解密,JavaScript 解密,任何JS加密都能100%解密,以及JS 加密讲解
Javascript 加密/压缩后运行不了,JavaScript报错排查讲解
分解质因数 JavaScript 计算方式,及分解质因数讲解
Javascript不可逆加密,JS加密工具sojson.v5 版本更新说明
JS加密V6版本上线了,JS加密升级,原来的sojson.v5加密升级到JS加密第六个版本!!!
JavaScript function 类型的使用说明
怎么合理管理、提高Javascript的性能
json 解析与生成工具类 ,JSON操作讲解(附件)
JSON格式讲解JSON获取对象,JSONObject和JSONArray的操作
JS加密,JS在线混淆加密,JavaScript在线加密
最新文章
使用七牛云存储实现图片API,自动删除图片方案合集 409
神速ICP备案经验分享,ICP备案居然一天就通过了 1641
百度加强推送URL链接,百度SEO强行推送链接JavaScript代码案例讲解。 2648
SOJSON 拓展服务器被DDos攻击了一晚上,是如何解决的? 2885
湖南地区备案“新增网站需提交组网方案或解释说明”,关于备案做简单叙述 2859
企查查你是个什么企业,骗子的帮凶,诈骗的集中营,通过企查查骚扰企业电话不断,为所欲为的企查查 8929
Java爬取百度云观测对网站的检测数据,获取子域名及域名的安全信息 2388
【2020年】百度搜索词获取,获取百度搜索的关键词【真实有效】 6270
Nodejs环境安装,Nodejs环境安装一篇就够了 1610
iOS版淘宝打开提示“您使用的程序是内测版本,将于2020-03-28到期,到期将无法使用,请尽快下载最新版本” 2411
最热文章
苹果电脑Mac怎么恢复出厂系统?苹果系统怎么重装系统? 423282
我为什么要选择RabbitMQ ,RabbitMQ简介,各种MQ选型对比 414091
免费天气API,全国天气 JSON API接口,可以获取五天的天气预报 347033
最新MyEclipse8.5注册码,有效期到2020年 (已经更新) 298991
免费天气API,天气JSON API,不限次数获取十五天的天气预报 278629
Elasticsearch教程(四) elasticsearch head 插件安装和使用 216231
Jackson 时间格式化,时间注解 @JsonFormat 用法、时差问题说明 167946
谈谈斐讯路由器劫持,你用斐讯路由器,你需要知道的事情 133806
Elasticsearch教程(一),全程直播(小白级别) 117088
Elasticsearch教程(五) elasticsearch Mapping的创建 97477

骚码加入我们 / 千人QQ群:259217951

入群需要5元为的是没有垃圾广告,如果没有QQ钱包,可以加群主拉进。

二维码生成 来自 >> 二维码生成器

支付扫码

所有赞助/开支都讲公开明细,用于网站维护:赞助名单查看

查看我的收藏

正在加载... ...