# JSON ## 静态方法 ### parse JSON.parse() 方法用来解析 JSON 字符串,构造由字符串描述的对象。可能返回值是: UTSJSONObject/Array/number/boolean/string 等基本数据类型 > 特别说明: > HBuilderX3.9.0统一为以上规范,在HBuilderX3.9.0之前版本 返回值只可能是 UTSJSONObject, 基本数据类型会转换失败 > JSON.parse 目前仅支持第一个参数 ```ts const json = `{"result":true, "count":42}`; const obj = JSON.parse(json); console.log(obj["count"]); // expected output: 42 console.log(obj["result"]); // expected output: true ``` **注意** - JSON.parse 解析出来的对象,目前仅支持使用方括号[]访问 - 如果输入的字符串不是合法的json格式,则会返回 null - JSON.parse 接口内部通过[特殊方式读取了范型类型](../generics.md#使用限制),不支持传入动态的范型:比如将外层方法的普通范型参数传入 JSON.parse。 ### parse\(text: string) ```ts class Person { name:string = "" age:number = 0 } // 带泛型的parse,这里的personObj 类型是 我们定义的`Persion`类 let personObj = JSON.parse('{"name":"zhangsan","age":12}') // 不带泛型的parse,这里的jsonObj类型是通用的`UTSJSONObject` let jsonObj = JSON.parse('{"name":"zhangsan","age":12}') ``` HBuilderX 3.9+,支持JSON.parse传入[泛型](../generics.md)。 与不带泛型的JSON.parse 相比,多了一个`` 尖括号 用来指定返回类型。 相比不带泛型的`parse`函数,带泛型的 `parse`函数,会提高反序列数据的开发效率,明确的结构数据可以提升工程健壮度 ### stringify(value, replacer?, space?) *注意:JSON.stringify 目前仅支持第一个参数* ```ts console.log(JSON.stringify({ x: 5, y: 6 })); // expected output: "{"x":5,"y":6}" console.log(JSON.stringify([3, 'false', boolean])); // expected output: "[3,"false",false]" console.log(JSON.stringify(new Date(2006, 0, 2, 15, 4, 5))); // expected output: ""2006-01-02T15:04:05.000Z"" ``` 序列化规则说明: |类型名称 |适应范围 |规则| |:-- |:-- |:--| |基本类型 |number/string/boolean |对应json格式中的 原型数据类型| |容器数据类型|UTSArray/UTSJSONObject |对应json格式中的 jsonarray/jsonobject| |map和set |map和set |与web保持一致,序列化为 空jsonobject对象: `{}`| |自定义type |开发者使用type 声明的类型对象 |被序列化为 jsonobject| |自定义class |开发者使用class 声明的类型对象 |被序列化为 空jsonobject对象: `{}` | |function |对象内部声明的函数 |被序列化为 `null` | ### parseObject(text: string) 注意: 此函数需要 HBuilderX 3.9x 以上版本 ### parseObject\(text: string) 注意: 此函数需要 HBuilderX 3.9x 以上版本 ### parseArray(text: string) 注意: 此函数需要 HBuilderX 3.9x 以上版本 ### parseArray\(text: string) 注意: 此函数需要 HBuilderX 3.9x 以上版本