如何在 Typescript 中解析 JSON 字符串

Question

有没有办法在 Typescript 中将字符串解析为 JSON。
示例：在 JS 中，我们可以使用JSON.parse() 。 Typescript 中是否有类似的功能？

我有一个 JSON 对象字符串，如下所示：

{"name": "Bob", "error": false}

Answer 1

Typescript 是 javascript（的超集），因此您只需像在 javascript 中一样使用JSON.parse ：

let obj = JSON.parse(jsonString);

只有在打字稿中，您才能拥有结果对象的类型：

interface MyObj {
    myString: string;
    myNumber: number;
}

let obj: MyObj = JSON.parse('{ "myString": "string", "myNumber": 4 }');
console.log(obj.myString);
console.log(obj.myNumber);

（ 操场上的代码）

Answer 2

类型安全的JSON.parse

你可以继续使用JSON.parse ，因为 TS 是一个 JS 超集。 仍然存在一个问题： JSON.parse返回any ，这破坏了类型安全。 对于更强的类型，这里有两个选项：

1. 自定义类型守卫（ playground ）

自定义类型保护是最简单的解决方案，通常足以进行外部数据验证：

// For example, you expect to parse a given value with `MyType` shape
type MyType = { name: string; description: string; }

// Validate this value with a custom type guard
function isMyType(o: any): o is MyType {
  return "name" in o && "description" in o
}

然后JSON.parse包装器可以将类型保护作为输入并返回解析后的类型值：

const safeJsonParse = <T>(guard: (o: any) => o is T) => (text: string): ParseResult<T> => {
  const parsed = JSON.parse(text)
  return guard(parsed) ? { parsed, hasError: false } : { hasError: true }
}

type ParseResult<T> =
  | { parsed: T; hasError: false; error?: undefined }
  | { parsed?: undefined; hasError: true; error?: unknown }

用法示例：

 const json = '{ "name": "Foo", "description": "Bar" }'; const result = safeJsonParse(isMyType)(json) // result: ParseResult<MyType> if (result.hasError) { console.log("error :/") // further error handling here } else { console.log(result.parsed.description) // result.parsed now has type `MyType` }

safeJsonParse可能会扩展为快速失败或尝试/捕获JSON.parse错误。

2. 外部库

如果您需要验证许多不同的值，手动编写类型保护函数会变得很麻烦。 有一些库可以帮助完成此任务 - 示例（没有完整列表）：

• io-ts ：相对。 流行（目前 3.2k 星）， fp-ts对等依赖，函数式编程风格
• zod ：相当新（repo：2020-03-07），努力比io-ts更加程序化/面向对象
• typescript-is : 用于编译器 API 的 TS 转换器，需要额外的包装器，如ttypescript
• ajv typescript-json-schema / ajv ：从类型创建 JSON 模式并使用ajv对其进行ajv

更多信息

• 运行时类型检查 #1573
• 使用 Typescript 检查接口类型
• TypeScript：验证外部数据

Answer 3

如果您希望 JSON 具有经过验证的 Typescript 类型，则需要自己进行验证工作。 这不是什么新鲜事。 在普通的 Javascript 中，你需要做同样的事情。

验证

我喜欢将我的验证逻辑表示为一组“转换”。 我将Descriptor定义为转换映射：

type Descriptor<T> = {
  [P in keyof T]: (v: any) => T[P];
};

然后我可以创建一个函数，将这些转换应用于任意输入：

function pick<T>(v: any, d: Descriptor<T>): T {
  const ret: any = {};
  for (let key in d) {
    try {
      const val = d[key](v[key]);
      if (typeof val !== "undefined") {
        ret[key] = val;
      }
    } catch (err) {
      const msg = err instanceof Error ? err.message : String(err);
      throw new Error(`could not pick ${key}: ${msg}`);
    }
  }
  return ret;
}

现在，我不仅在验证我的 JSON 输入，而且我正在构建一个 Typescript 类型。 上述泛型类型确保结果从您的“转换”中推断出类型。

如果转换抛出错误（这就是您实现验证的方式），我喜欢用另一个错误包装它，显示哪个键导致了错误。

用法

在您的示例中，我将按如下方式使用它：

const value = pick(JSON.parse('{"name": "Bob", "error": false}'), {
  name: String,
  error: Boolean,
});

现在value将被键入，因为String和Boolean都是“转换器”，因为它们接受输入并返回类型化的输出。

此外，该value实际上将是该类型。 换句话说，如果name实际上是123 ，它将被转换为"123"以便您拥有一个有效的字符串。 这是因为我们在运行时使用了String ，这是一个接受任意输入并返回string的内置函数。

你可以在这里看到这个工作。 尝试以下事情来说服自己：

• 将鼠标悬停在const value定义上以查看弹出窗口是否显示正确的类型。
• 尝试将"Bob"更改为123并重新运行示例。 在您的控制台中，您将看到名称已正确转换为字符串"123" 。

Answer 4

有一个很棒的库ts-json-object

在您的情况下，您需要运行以下代码：

import {JSONObject, required} from 'ts-json-object'

class Response extends JSONObject {
    @required
    name: string;

    @required
    error: boolean;
}

let resp = new Response({"name": "Bob", "error": false});

该库将在解析之前验证 json

Answer 5

您还可以使用执行 json 类型验证的库，例如Sparkson 。 它们允许你定义一个 TypeScript 类，你想解析你的响应，在你的情况下它可能是：

import { Field } from "sparkson";
class Response {
   constructor(
      @Field("name") public name: string,
      @Field("error") public error: boolean
   ) {}
}

该库将验证 JSON 负载中是否存在必需字段以及它们的类型是否正确。 它还可以进行一堆验证和转换。

Answer 6

使用app.quicktype.io在 TypeScript 中安全地解析 JSON。 稍后会详细介绍。 JSON.parse()返回类型any并且在“快乐路径”中就足够了，但可能会导致与下游类型安全相关的错误，这违背了 TypeScript 的目的。 例如：

interface User {
  name: string,
  balance: number
}

const json = '{"name": "Bob", "balance": "100"}' //note the string "100"
const user:User = JSON.parse(json)

const newBalance = user.balance + user.balance * 0.05 //should be 105 after interest
console.log(newBalance ) //but it ends up as 1005 which is clearly wrong

所以让 quicktype 做繁重的工作并生成代码。 将下面的字符串复制并粘贴到 quicktype 中。

{
  "name": "Bob",
  "balance": 100
}

确保选择TypeScript作为语言并启用“在运行时验证 JSON.parse 结果”

现在我们可以在解析时防御性地处理异常（如果有）并防止下游发生错误。

import { Convert, User } from "./user";

const json =
  '{"firstName": "Kevin", "lastName": "Le", "accountBalance": "100"}';

try {
  const user = Convert.toUser(json);
  console.log(user);
} catch (e) {
  console.log("Handle error", e);
}

user.ts是 quicktype 生成的文件。

// To parse this data:
//
//   import { Convert, User } from "./file";
//
//   const user = Convert.toUser(json);
//
// These functions will throw an error if the JSON doesn't
// match the expected interface, even if the JSON is valid.

export interface User {
    name:    string;
    balance: number;
}

// Converts JSON strings to/from your types
// and asserts the results of JSON.parse at runtime
export class Convert {
    public static toUser(json: string): User {
        return cast(JSON.parse(json), r("User"));
    }

    public static userToJson(value: User): string {
        return JSON.stringify(uncast(value, r("User")), null, 2);
    }
}

function invalidValue(typ: any, val: any, key: any = ''): never {
    if (key) {
        throw Error(`Invalid value for key "${key}". Expected type ${JSON.stringify(typ)} but got ${JSON.stringify(val)}`);
    }
    throw Error(`Invalid value ${JSON.stringify(val)} for type ${JSON.stringify(typ)}`, );
}

function jsonToJSProps(typ: any): any {
    if (typ.jsonToJS === undefined) {
        const map: any = {};
        typ.props.forEach((p: any) => map[p.json] = { key: p.js, typ: p.typ });
        typ.jsonToJS = map;
    }
    return typ.jsonToJS;
}

function jsToJSONProps(typ: any): any {
    if (typ.jsToJSON === undefined) {
        const map: any = {};
        typ.props.forEach((p: any) => map[p.js] = { key: p.json, typ: p.typ });
        typ.jsToJSON = map;
    }
    return typ.jsToJSON;
}

function transform(val: any, typ: any, getProps: any, key: any = ''): any {
    function transformPrimitive(typ: string, val: any): any {
        if (typeof typ === typeof val) return val;
        return invalidValue(typ, val, key);
    }

    function transformUnion(typs: any[], val: any): any {
        // val must validate against one typ in typs
        const l = typs.length;
        for (let i = 0; i < l; i++) {
            const typ = typs[i];
            try {
                return transform(val, typ, getProps);
            } catch (_) {}
        }
        return invalidValue(typs, val);
    }

    function transformEnum(cases: string[], val: any): any {
        if (cases.indexOf(val) !== -1) return val;
        return invalidValue(cases, val);
    }

    function transformArray(typ: any, val: any): any {
        // val must be an array with no invalid elements
        if (!Array.isArray(val)) return invalidValue("array", val);
        return val.map(el => transform(el, typ, getProps));
    }

    function transformDate(val: any): any {
        if (val === null) {
            return null;
        }
        const d = new Date(val);
        if (isNaN(d.valueOf())) {
            return invalidValue("Date", val);
        }
        return d;
    }

    function transformObject(props: { [k: string]: any }, additional: any, val: any): any {
        if (val === null || typeof val !== "object" || Array.isArray(val)) {
            return invalidValue("object", val);
        }
        const result: any = {};
        Object.getOwnPropertyNames(props).forEach(key => {
            const prop = props[key];
            const v = Object.prototype.hasOwnProperty.call(val, key) ? val[key] : undefined;
            result[prop.key] = transform(v, prop.typ, getProps, prop.key);
        });
        Object.getOwnPropertyNames(val).forEach(key => {
            if (!Object.prototype.hasOwnProperty.call(props, key)) {
                result[key] = transform(val[key], additional, getProps, key);
            }
        });
        return result;
    }

    if (typ === "any") return val;
    if (typ === null) {
        if (val === null) return val;
        return invalidValue(typ, val);
    }
    if (typ === false) return invalidValue(typ, val);
    while (typeof typ === "object" && typ.ref !== undefined) {
        typ = typeMap[typ.ref];
    }
    if (Array.isArray(typ)) return transformEnum(typ, val);
    if (typeof typ === "object") {
        return typ.hasOwnProperty("unionMembers") ? transformUnion(typ.unionMembers, val)
            : typ.hasOwnProperty("arrayItems")    ? transformArray(typ.arrayItems, val)
            : typ.hasOwnProperty("props")         ? transformObject(getProps(typ), typ.additional, val)
            : invalidValue(typ, val);
    }
    // Numbers can be parsed by Date but shouldn't be.
    if (typ === Date && typeof val !== "number") return transformDate(val);
    return transformPrimitive(typ, val);
}

function cast<T>(val: any, typ: any): T {
    return transform(val, typ, jsonToJSProps);
}

function uncast<T>(val: T, typ: any): any {
    return transform(val, typ, jsToJSONProps);
}

function a(typ: any) {
    return { arrayItems: typ };
}

function u(...typs: any[]) {
    return { unionMembers: typs };
}

function o(props: any[], additional: any) {
    return { props, additional };
}

function m(additional: any) {
    return { props: [], additional };
}

function r(name: string) {
    return { ref: name };
}

const typeMap: any = {
    "User": o([
        { json: "name", js: "name", typ: "" },
        { json: "balance", js: "balance", typ: 0 },
    ], false),
};

Answer 7

JSON.parse在 TypeScript 中可用，所以你可以直接使用它：

JSON.parse('{"name": "Bob", "error": false}') // Returns a value of type 'any'

但是，您通常希望在解析 JSON 对象的同时确保它匹配特定类型，而不是处理any类型的值。 在这种情况下，您可以定义如下函数：

function parse_json<TargetType extends Object>(
  json: string,
  type_definitions: { [Key in keyof TargetType]: (raw_value: any) => TargetType[Key] }
): TargetType {
  const raw = JSON.parse(json); 
  const result: any = {};
  for (const key in type_definitions) result[key] = type_definitions[key](raw[key]);
  return result;
}

此函数接受一个 JSON 字符串和一个对象，该对象包含加载您正在创建的对象的每个字段的各个函数。 你可以像这样使用它：

const value = parse_json(
  '{"name": "Bob", "error": false}',
  { name: String, error: Boolean, }
);

Answer 8

TS 有一个 JavaScript 运行时

Typescript 有一个 JavaScript 运行时，因为它被编译成 JS。 这意味着作为语言一部分内置的 JS 对象，例如JSON 、 Object和Math也可以在 TS 中使用。 因此我们可以使用JSON.parse方法来解析 JSON 字符串。

示例：

const JSONStr = '{"name": "Bob", "error": false}'

// The JSON object is part of the runtime
const parsedObj = JSON.parse(JSONStr);

console.log(parsedObj);
// [LOG]: {
//   "name": "Bob",
//   "error": false
// } 

// The Object object is also part of the runtime so we can use it in TS
const objKeys = Object.keys(parsedObj);

console.log(objKeys);
// [LOG]: ["name", "error"] 

现在唯一的事情是 parsedObj 是any类型，这在 TS 中通常是不好的做法。 如果我们使用类型保护，我们可以输入对象。 下面是一个例子：

const JSONStr = '{"name": "Bob", "error": false}'
const parsedObj = JSON.parse(JSONStr);

interface nameErr {
  name: string;
  error: boolean;
}

function isNameErr(arg: any): arg is nameErr {
  if (typeof arg.name === 'string' && typeof arg.error === 'boolean') {
    return true;
  } else {
    return false;
  }
}

if (isNameErr(parsedObj)) {
  // Within this if statement parsedObj is type nameErr;
  parsedObj
}

Answer 9

嘿，如果你对 json 对象进行typeof 操作，结果是字符串，它是打字稿。 您可以在此处阅读更多相关信息： Typescript: difference between String and string

所以试试这个方法，它会起作用——

JSON.parse(String({"name": "Bob", "error": false}))

Answer 10

在我的例子中，我想要JSON.stringify(result)而不是JSON.parse() 。 当你需要console.log并且它给你[object Object]然后使用

console.log(JSON.stringify(result))

获得纯文本消息。

Answer 11

是的，它在TypeScript 中有点棘手，但您可以像这样执行以下示例

 let decodeData = JSON.parse(`${jsonResponse}`);