如何让TypeScript识别含toString()的类可作为字符串使用？

我有一个包含.toString()方法的类：

class StringableItem {
    text: string

    constructor(str: string) {
        this.text = str
    }

    toString() {
        return this.text
    }
}

const foo = new StringableItem('hey')

在模板字符串场景中，TypeScript能自动识别实例可转换为字符串，不会报错：

const alpha: string = `${foo}`
const bravo = `${foo}`

但直接将实例赋值给string类型变量时，会触发类型错误：Type 'StringableItem' is not assignable to type 'string'：

let charlie: string = ''
charlie = foo // 类型错误

以下是几种让该类实例兼容string类型场景的方案：

方案1：手动调用toString()（最安全直观） #

直接调用实例的toString()方法获取字符串值，完全符合TypeScript类型规则：

charlie = foo.toString();

方案2：使用类型断言（跳过类型检查） #

如果能确保实例可安全转换为字符串，可通过类型断言强制转换类型，注意这会绕过TypeScript的类型校验，需自行保证逻辑安全：

charlie = foo as unknown as string;

方案3：实现Symbol.toPrimitive并结合类型别名 #

实现Symbol.toPrimitive方法让实例在隐式转换时返回字符串，同时定义类型别名让TypeScript识别类与string的兼容性：

class StringableItem {
    text: string

    constructor(str: string) {
        this.text = str
    }

    toString() {
        return this.text
    }

    [Symbol.toPrimitive](hint: 'string' | 'number' | 'default') {
        if (hint === 'string' || hint === 'default') {
            return this.text;
        }
        throw new Error('仅支持转换为字符串');
    }
}

// 定义类型别名，让TypeScript识别实例可视为string
type Stringable = StringableItem & string;

const foo = new StringableItem('hey') as Stringable;
let charlie: string = '';
charlie = foo; // 无类型错误

方案4：封装通用转换函数（兼顾安全与便捷） #

编写一个通用转换函数，自动处理所有带有toString()方法的类型，同时保证类型安全：

function toSafeString<T extends { toString(): string }>(value: T): string {
    return value.toString();
}

charlie = toSafeString(foo);

内容的提问来源于stack exchange，提问作者craigpatik