@jayfong/x-utils 1.0.0-202407012223

package/_cjs/ocr.js

@@ -0,0 +1,74 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ocr_exports = {};
+__export(ocr_exports, {
+  XOcr: () => XOcr
+});
+module.exports = __toCommonJS(ocr_exports);
+var import_x_request = require("@jayfong/x-request");
+var import_env = require("./env.js");
+class XOcr {
+  static async recognize(url, {
+    serverUrl
+  } = {}) {
+    if (serverUrl == null) {
+      serverUrl = await import_env.XEnv.getEnvVar("X_OCR_RECOGNIZE_SERVER_URL");
+    }
+    const { data: buffer } = await import_x_request.xr.get({
+      url,
+      autoReferer: true
+    });
+    const base64 = buffer.toString("base64");
+    const { data: res } = await import_x_request.xr.postJson({
+      url: serverUrl,
+      data: {
+        base64,
+        options: {}
+      }
+    });
+    if (res.code !== 100) {
+      if (res.data.includes("No text found in image")) {
+        return "";
+      }
+      throw new Error(res.data);
+    }
+    return res.data.map((item) => item.text).join(" ");
+  }
+  static async recognizeCaptcha(buffer, {
+    serverUrl,
+    serverToken
+  } = {}) {
+    if (serverUrl == null) {
+      serverUrl = await import_env.XEnv.getEnvVar("X_OCR_RECOGNIZE_CAPTCHA_SERVER_URL");
+    }
+    if (serverToken == null) {
+      serverToken = await import_env.XEnv.getEnvVar(
+        "X_OCR_RECOGNIZE_CAPTCHA_SERVER_TOKEN"
+      );
+    }
+    const res = await import_x_request.xr.postJson({
+      url: serverUrl,
+      data: import_x_request.xr.formData({
+        token: serverToken,
+        file: import_x_request.xr.formFile(buffer, { name: "xx.png" })
+      })
+    });
+    return res.data.text;
+  }
+}

package/_cjs/path.js

@@ -0,0 +1,35 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var path_exports = {};
+__export(path_exports, {
+  XPath: () => XPath
+});
+module.exports = __toCommonJS(path_exports);
+var import_pathe = __toESM(require("pathe"), 1);
+const XPath = import_pathe.default;

package/_cjs/pinyin.js

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pinyin_exports = {};
+__export(pinyin_exports, {
+  XPinyin: () => XPinyin
+});
+module.exports = __toCommonJS(pinyin_exports);
+var import_pinyin_pro = require("pinyin-pro");
+class XPinyin {
+  static getTonelessPinyin(text) {
+    return (0, import_pinyin_pro.pinyin)(text, {
+      type: "array",
+      toneType: "none"
+    });
+  }
+}

package/_cjs/puppeteer.js

@@ -0,0 +1,271 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var puppeteer_exports = {};
+__export(puppeteer_exports, {
+  XPuppeteer: () => XPuppeteer
+});
+module.exports = __toCommonJS(puppeteer_exports);
+var import_x_request = require("@jayfong/x-request");
+var import_exit_hook = require("exit-hook");
+var import_puppeteer = __toESM(require("puppeteer"), 1);
+var import_vtils = require("vtils");
+var import_clipboard = require("./clipboard.js");
+class XPuppeteer {
+  browser;
+  async connectSystemBrowser() {
+    const {
+      data: { webSocketDebuggerUrl }
+    } = await import_x_request.xr.getJson({
+      url: "http://localhost:9222/json/version"
+    });
+    const browser = await import_puppeteer.default.connect({
+      browserWSEndpoint: webSocketDebuggerUrl,
+      // 都设为 0 以保持原有的宽高
+      defaultViewport: {
+        width: 0,
+        height: 0
+      }
+    });
+    this.browser = browser;
+    (0, import_exit_hook.asyncExitHook)(() => this.disconnect(), {
+      wait: 1e3
+    });
+    return browser;
+  }
+  async openBrowser(options = {}) {
+    const browser = await import_puppeteer.default.launch({
+      headless: options.headful ? false : true,
+      defaultViewport: {
+        width: 1440,
+        height: 900
+      },
+      userDataDir: options.dataDir,
+      args: options.proxy ? [`--proxy-server=${options.proxy}`] : void 0
+    });
+    this.browser = browser;
+    (0, import_exit_hook.asyncExitHook)(() => this.close(), {
+      wait: 1e3
+    });
+    return browser;
+  }
+  async openPage(urlOrHtml, options = {}) {
+    const isUrl = /^https?:\/\//i.test(urlOrHtml);
+    const pages = await this.browser.pages();
+    if (isUrl) {
+      const inputUrl = new URL(urlOrHtml);
+      const foundPage = pages.find((item) => {
+        const pageUrl = item.url();
+        const url = new URL(pageUrl);
+        return inputUrl.origin === url.origin && (pageUrl === urlOrHtml || !!options.match && (typeof options.match === "string" ? `${url.pathname}${url.search}`.includes(options.match) : options.match.test(`${url.pathname}${url.search}`)));
+      });
+      if (foundPage) {
+        return foundPage;
+      }
+    }
+    const page2 = await this.browser.newPage();
+    await page2.setUserAgent(
+      "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36"
+    );
+    if (options.blockAssets) {
+      await page2.setRequestInterception(true);
+      page2.on("request", (req) => {
+        const resourceType = req.resourceType();
+        if (resourceType === "stylesheet" || resourceType === "font" || resourceType === "image") {
+          req.abort();
+        } else {
+          req.continue();
+        }
+      });
+    }
+    if (isUrl) {
+      await page2.goto(urlOrHtml, {
+        referer: options.referer || urlOrHtml
+      });
+    } else {
+      await page2.setContent(urlOrHtml);
+    }
+    return page2;
+  }
+  async input(page2, selector, textOrHtml, frameIndex) {
+    const mainPage = page2;
+    const keyboard = page2.keyboard;
+    if (frameIndex != null) {
+      page2 = page2.frames()[frameIndex];
+    }
+    const el2 = await page2.$(selector);
+    const isText = await el2.evaluate((el3) => {
+      const isInput = el3.tagName === "INPUT" || el3.tagName === "TEXTAREA";
+      const isText2 = isInput || el3.tagName === "SPAN";
+      return isText2;
+    });
+    if (isText) {
+      await import_clipboard.XClipboard.writeText(textOrHtml);
+    } else {
+      await import_clipboard.XClipboard.writeHtml(textOrHtml);
+    }
+    await el2.click();
+    await this.selectAll(page2);
+    await keyboard.press("Backspace");
+    await this.paste(mainPage);
+  }
+  async selectAll(page2) {
+    await page2.evaluate(() => {
+      const isMac = /Mac|iPod|iPhone|iPad/.test(window.navigator.platform);
+      document.activeElement.dispatchEvent(
+        new KeyboardEvent("keydown", {
+          bubbles: true,
+          cancelable: true,
+          key: isMac ? "Meta" : "Control",
+          code: isMac ? "MetaLeft" : "ControlLeft",
+          location: window.KeyboardEvent.DOM_KEY_LOCATION_LEFT,
+          // @ts-ignore
+          getModifierState: (keyArg) => keyArg === (isMac ? "Meta" : "Control"),
+          ctrlKey: !isMac,
+          metaKey: isMac,
+          charCode: 0,
+          keyCode: isMac ? 93 : 17,
+          which: isMac ? 93 : 17
+        })
+      );
+      const preventableEvent = new KeyboardEvent("keydown", {
+        bubbles: true,
+        cancelable: true,
+        key: "a",
+        code: "KeyA",
+        location: window.KeyboardEvent.DOM_KEY_LOCATION_STANDARD,
+        // @ts-ignore
+        getModifierState: (keyArg) => keyArg === (isMac ? "Meta" : "Control"),
+        ctrlKey: !isMac,
+        metaKey: isMac,
+        charCode: 0,
+        keyCode: 65,
+        which: 65
+      });
+      const wasPrevented = !document.activeElement.dispatchEvent(preventableEvent) || preventableEvent.defaultPrevented;
+      if (!wasPrevented) {
+        document.execCommand("selectall", false, null);
+      }
+      document.activeElement.dispatchEvent(
+        new KeyboardEvent("keyup", {
+          bubbles: true,
+          cancelable: true,
+          key: isMac ? "Meta" : "Control",
+          code: isMac ? "MetaLeft" : "ControlLeft",
+          location: window.KeyboardEvent.DOM_KEY_LOCATION_LEFT,
+          // @ts-ignore
+          getModifierState: () => false,
+          charCode: 0,
+          keyCode: isMac ? 93 : 17,
+          which: isMac ? 93 : 17
+        })
+      );
+    });
+  }
+  async paste(page2) {
+    await page2.keyboard.down("Shift");
+    await page2.keyboard.press("Insert");
+    await page2.keyboard.up("Shift");
+  }
+  async queryByText(page, text) {
+    const el = await page.evaluateHandle(
+      (text, isRegExp, isFunction) => {
+        const textRe = isRegExp ? (() => {
+          const m = text.match(/^\/(.+)\/([^/]*)$/);
+          return new RegExp(m[1], m[2] || void 0);
+        })() : void 0;
+        const textFn = isFunction ? eval(`(() => {return ${text}})()`) : void 0;
+        const walker = document.createTreeWalker(
+          document.body,
+          NodeFilter.SHOW_TEXT,
+          {
+            acceptNode: (node) => {
+              return (isRegExp ? textRe.test(node.textContent) : isFunction ? textFn(node) : node.textContent.includes(text)) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_REJECT;
+            }
+          }
+        );
+        walker.nextNode();
+        return walker.currentNode.parentElement;
+      },
+      String(text),
+      (0, import_vtils.isRegExp)(text),
+      (0, import_vtils.isFunction)(text)
+    );
+    return el;
+  }
+  async disconnect() {
+    await this.browser.disconnect();
+  }
+  async close() {
+    await this.browser.close();
+  }
+  static async openBrowser(options = {}) {
+    const xp = new XPuppeteer();
+    await xp.openBrowser(options);
+    return xp;
+  }
+  static async openPage(urlOrHtml, options = {}) {
+    const xp = new XPuppeteer();
+    await xp.openBrowser(options);
+    const page2 = await xp.openPage(urlOrHtml, options);
+    page2.close = () => xp.close();
+    return page2;
+  }
+  static getPageHtmlXp = (0, import_vtils.memoize)(
+    async (options) => {
+      const xp = new XPuppeteer();
+      await (options.useSystemBrowser ? xp.connectSystemBrowser() : xp.openBrowser(options));
+      return xp;
+    },
+    (options) => options.instanceId
+  );
+  static async getPageHtml(url, options = {}) {
+    const hasInstanceId = !!options.instanceId;
+    options.instanceId ||= Date.now();
+    const xp = await XPuppeteer.getPageHtmlXp(options);
+    try {
+      const page2 = await xp.openPage(url, options);
+      if (options.afterOpenPage) {
+        await options.afterOpenPage({
+          browser: xp,
+          page: page2
+        });
+      }
+      const html = await page2.content();
+      return html;
+    } finally {
+      if (!hasInstanceId) {
+        if (options.useSystemBrowser) {
+          await xp.disconnect();
+        } else {
+          await xp.close();
+        }
+      }
+    }
+  }
+}

package/_cjs/runner.js

@@ -0,0 +1,88 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var runner_exports = {};
+__export(runner_exports, {
+  XRunner: () => XRunner
+});
+module.exports = __toCommonJS(runner_exports);
+var import_inquirer = __toESM(require("inquirer"), 1);
+var import_vtils = require("vtils");
+var import_fs = require("./fs.js");
+class XRunner {
+  constructor(options) {
+    this.options = options;
+  }
+  async run() {
+    await import_fs.XFs.ensureFile(this.options.configFile);
+    const savedConfig = await import_fs.XFs.readJson(this.options.configFile, { throws: false }) || {};
+    const config = await import_inquirer.default.prompt(
+      this.options.questions.map((item) => {
+        return {
+          ...item,
+          default: savedConfig[item.name] ?? item.default
+        };
+      })
+    );
+    await import_fs.XFs.writeJson(this.options.configFile, config, { spaces: 2 });
+    let retryCount = 0;
+    while (true) {
+      try {
+        await this.options.run(config);
+        retryCount = 0;
+      } catch (err) {
+        const delay = typeof this.options.delay === "function" ? this.options.delay(retryCount) : this.options.delay;
+        console.log(err);
+        console.log(`\u6267\u884C\u62A5\u9519, \u7B49\u5F85${delay}`);
+        await (0, import_vtils.wait)((0, import_vtils.ms)(delay));
+        retryCount++;
+      }
+    }
+  }
+}
+new XRunner({
+  configFile: "./temp/test.json",
+  delay: "1s",
+  questions: [
+    {
+      name: "perCount",
+      message: "\u6BCF\u8F6E\u5904\u7406\u6761\u6570",
+      type: "number",
+      default: 500
+    },
+    {
+      name: "concurrencyCount",
+      message: "\u6BCF\u8F6E\u5E76\u884C\u5904\u7406\u6761\u6570",
+      type: "number",
+      default: 1
+    }
+  ],
+  run: (config) => {
+    console.log(config);
+  }
+}).run();

package/_cjs/task.js

@@ -0,0 +1,41 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var task_exports = {};
+__export(task_exports, {
+  XTask: () => XTask
+});
+module.exports = __toCommonJS(task_exports);
+var import_consola = require("consola");
+var import_exit_hook = require("exit-hook");
+class XTask {
+  log = import_consola.consola;
+  async dispose() {
+  }
+  run() {
+    (0, import_exit_hook.asyncExitHook)(() => this.dispose(), {
+      wait: 3e3
+    });
+    return this.start().then(() => {
+      (0, import_exit_hook.gracefulExit)(0);
+    }).catch((err) => {
+      import_consola.consola.error(err);
+      (0, import_exit_hook.gracefulExit)(1);
+    });
+  }
+}

package/_cjs/text.js

@@ -0,0 +1,136 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var text_exports = {};
+__export(text_exports, {
+  XText: () => XText
+});
+module.exports = __toCommonJS(text_exports);
+var import_html_entities = require("html-entities");
+class XText {
+  constructor(text) {
+    this.text = text;
+  }
+  /**
+   * 将字符串分割为字符数组。
+   *
+   * @see https://stackoverflow.com/a/71619350
+   */
+  static split(text) {
+    return [...new Intl.Segmenter().segment(text)].map((x) => x.segment);
+  }
+  /**
+   * 纯粹为了书写 HTML 有提示。
+   */
+  static html(literals, ...interpolations) {
+    let result = "";
+    for (let i = 0; i < interpolations.length; i++) {
+      result += literals[i];
+      result += interpolations[i];
+    }
+    result += literals[literals.length - 1];
+    return result;
+  }
+  /**
+   * 切割字符串。
+   */
+  static cut(text, start, end) {
+    text = text.split(start)[1].split(end)[0];
+    return text;
+  }
+  /**
+   * 移除全部空白字符。
+   */
+  static stripWhitespace(text) {
+    text = text.replace(/\s+/g, "");
+    return text;
+  }
+  /**
+   * 移除首尾空白字符。
+   */
+  static stripMarginWhitespace(text) {
+    text = text.trim();
+    return text;
+  }
+  /**
+   * HTML 实体编码。
+   */
+  static encodeHtmlEntity(text) {
+    text = (0, import_html_entities.encode)(text);
+    return text;
+  }
+  /**
+   * HTML 实体解码。
+   */
+  static decodeHtmlEntity(text) {
+    text = (0, import_html_entities.decode)(text);
+    return text;
+  }
+  /**
+   * 移除 HTML 代码。
+   */
+  static stripHtml(text) {
+    text = text.replace(/<script[\s>].+?<\/script>/g, "").replace(/<style[\s>].+?<\/style>/g, "").replace(/<(.+?)>/g, "");
+    return text;
+  }
+  /**
+   * 切割字符串。
+   */
+  cut(start, end) {
+    this.text = XText.cut(this.text, start, end);
+    return this;
+  }
+  /**
+   * 移除全部空白字符。
+   */
+  stripWhitespace() {
+    this.text = XText.stripWhitespace(this.text);
+    return this;
+  }
+  /**
+   * 移除首尾空白字符。
+   */
+  stripMarginWhitespace() {
+    this.text = XText.stripMarginWhitespace(this.text);
+    return this;
+  }
+  /**
+   * HTML 实体编码。
+   */
+  encodeHtmlEntity() {
+    this.text = XText.encodeHtmlEntity(this.text);
+    return this;
+  }
+  /**
+   * HTML 实体解码。
+   */
+  decodeHtmlEntity() {
+    this.text = XText.decodeHtmlEntity(this.text);
+    return this;
+  }
+  /**
+   * 移除 HTML 代码。
+   */
+  stripHtml() {
+    this.text = XText.stripHtml(this.text);
+    return this;
+  }
+  toString() {
+    return this.text;
+  }
+}