feat(x): 新增 parseXml、createXml

package.json

@@ -48,6 +48,10 @@
     "./validator": {
       "require": "./_cjs/validator/index.js",
       "import": "./validator/index.js"
+    },
+    "./x": {
+      "require": "./_cjs/x/index.js",
+      "import": "./x/index.js"
     }
   },
   "main": "_cjs/utils/index.js",
@@ -92,6 +96,7 @@
   "dependencies": {
     "@babel/runtime": "^7.12.5",
     "date-fns": "^2.16.1",
+    "fast-xml-parser": "^3.17.5",
     "lodash-uni": "^1.1.0",
     "miniprogram-api-typings": "^3.2.0",
     "react-use": "^15.3.4",

src/x/__snapshots__/createXml.test.ts.snap

@@ -0,0 +1,19 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`createXml 表现正常 1`] = `
+<id>
+  1
+</id>
+<name>
+  jay
+</name>
+<close>
+  false
+</close>
+<content>
+  <!--[CDATA[大家好 > kkkdkkdkd ?]]-->
+</content>
+<desc time="2020">
+  我是xxxx
+</desc>
+`;

src/x/__snapshots__/parseXml.test.ts.snap

@@ -0,0 +1,13 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`parseXml 表现正常 1`] = `
+Object {
+  "xml": Object {
+    "Content": "你好",
+    "CreateTime": 12345678,
+    "FromUserName": "fromUser",
+    "MsgType": "text",
+    "ToUserName": "toUser",
+  },
+}
+`;

src/x/createXml.test.ts

@@ -0,0 +1,20 @@
+import { createXml } from './createXml'
+
+describe('createXml', () => {
+  test('表现正常', () => {
+    expect(
+      createXml({
+        id: 1,
+        name: 'jay',
+        close: false,
+        content: createXml.cdata('大家好 > kkkdkkdkd ?'),
+        desc: {
+          ...createXml.attr({
+            time: '2020',
+          }),
+          ...createXml.text('我是xxxx'),
+        },
+      }),
+    ).toMatchSnapshot()
+  })
+})

src/x/createXml.ts

@@ -0,0 +1,32 @@
+import { j2xParser as J2XParser, J2xOptionsOptional } from 'fast-xml-parser'
+
+const attrTagName = '@__attr__@' as const
+const textTagName = '@__text__@' as const
+const cdataTagName = '@__cdata__@' as const
+
+/**
+ * 创建 XML 文本。
+ *
+ * @param data 数据
+ * @param options 选项
+ */
+export function createXml(data: any, options?: J2xOptionsOptional): string {
+  return new J2XParser({
+    ...options,
+    attrNodeName: attrTagName,
+    textNodeName: textTagName,
+    cdataTagName: cdataTagName,
+  }).parse(data)
+}
+
+createXml.attr = function <T = any>(value: T): any {
+  return { [attrTagName]: value }
+}
+
+createXml.text = function <T = any>(value: T): any {
+  return { [textTagName]: value }
+}
+
+createXml.cdata = function <T = any>(value: T): any {
+  return { [cdataTagName]: value }
+}

src/x/index.ts

@@ -0,0 +1,12 @@
+/**
+ * 第三方工具封装库。
+ *
+ * @packageDocumentation
+ */
+
+/* istanbul ignore file */
+
+// @index(['./**/*.ts', '!./**/*.test.*', '!**/__*'], f => `export * from '${f.path}'`)
+export * from './createXml'
+export * from './parseXml'
+// @endindex

src/x/parseXml.test.ts

@@ -0,0 +1,18 @@
+import { dedent } from '../utils'
+import { parseXml } from './parseXml'
+
+describe('parseXml', () => {
+  test('表现正常', () => {
+    expect(
+      parseXml(dedent`
+        <xml>
+          <ToUserName><![CDATA[toUser]]></ToUserName>
+          <FromUserName><![CDATA[fromUser]]></FromUserName>
+          <CreateTime>12345678</CreateTime>
+          <MsgType><![CDATA[text]]></MsgType>
+          <Content><![CDATA[你好]]></Content>
+        </xml>
+      `),
+    ).toMatchSnapshot()
+  })
+})

src/x/parseXml.ts

@@ -0,0 +1,11 @@
+import { parse, X2jOptionsOptional } from 'fast-xml-parser'
+
+/**
+ * 解析 XML 文本。
+ *
+ * @param text XML 文本
+ * @param options 选项
+ */
+export function parseXml<T>(text: string, options?: X2jOptionsOptional): T {
+  return parse(text, options)
+}