javascript中不存在自定义原始类型，所谓“基于原始类型的自定义数据类型”实为通过包装对象原型扩展、语义化构造函数封装或proxy拦截等方式，使原始值更安全、语义化地被使用。

JavaScript 中没有“自定义原始类型”这一概念——原始类型（string、number、boolean、null、undefined、symbol、bigint）是语言内置且不可扩展的底层值。所谓“基于原始类型的自定义数据类型”，实际是指：利用原始值 + 包装对象原型扩展 + 封装逻辑，模拟出具备特定行为和语义的新类型。核心不在于创造新原始类型，而在于让原始值更安全、更语义化地被使用。

用包装对象原型添加专属方法

原始值能调用方法，靠的是临时装箱为 String/Number/Boolean 等包装对象。你可以向这些原型添加方法，让所有对应原始值都能使用：

• 只在方法不存在时定义，避免覆盖原生行为：
  if (!String.prototype.isValidEmail) {
    String.prototype.isValidEmail = function() {
      return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(this);
    };
  }
• 方法内部的 this 指向原始值（如 "a@b.com"），可直接操作；返回新值，不修改原始值（符合不可变原则）
• 注意：null 和 undefined 无法扩展，它们没有对应的包装类

封装原始值为语义化构造函数

用函数或 class 包裹原始值，隐藏底层表示，暴露有意义的接口：

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

• 例如定义 Money 类型，内部用 number 存储分（整数），避免浮点精度问题：
  class Money {
    constructor(cents) {
      if (!Number.isInteger(cents)) throw new Error('cents must be integer');
      this.cents = cents;
    }
    toString() { return `¥${(this.cents / 100).toFixed(2)}`; }
    add(other) { return new Money(this.cents + other.cents); }
  }
• 用户不再直接操作数字，而是通过 new Money(199) 创建，调用 .add()、.toString() 等语义方法
• 可配合 Symbol.toPrimitive 或 valueOf 实现隐式转换（如参与 + 运算时自动转为数值）

用 Proxy + 原始值实现受控访问

若需拦截读写、校验、格式化等行为，可用 Proxy 包裹原始值，提供运行时保障：

• 例如创建一个只接受正整数的 PositiveInt 封装：
  function PositiveInt(value) {
    if (!Number.isInteger(value) || value     throw new TypeError('must be positive integer');
    }
    return new Proxy({ value }, {
      get(target, prop) {
        if (prop === 'value') return target.value;
        if (prop === 'isEven') return target.value % 2 === 0;
        return undefined;
      }
    });
  }
• 它不是新原始类型，但行为上更接近“类型系统”的约束效果
• 适合在关键业务逻辑中替代裸数字/字符串，提前暴露错误

配合 TypeScript 增强类型表达（运行时+编译时）

纯 JS 无法真正新增原始类型，但结合 TypeScript 可在开发阶段获得强提示与检查：

• 用 type Email = string & { __brand: 'Email' }; 创建“名义类型”，阻止 string 与 Email 互换赋值
• 配合运行时校验函数（如 function isEmail(s: string): s is Email { ... }），实现类型守卫
• 最终仍以 string 形式存在，但开发体验和安全性大幅提升