Skip to content

isSymbol

检查一个值是否是 symbol

此函数还可以作为 TypeScript 中的类型谓词,将参数的类型缩小为 symbol

签名

typescript
function isSymbol(value: unknown): value is symbol;

参数

  • value (unknown): 要检查的值。

返回值

(value is symbol): 如果值是 symbol 则返回 true,否则返回 false

示例

typescript
import { isSymbol } from 'es-toolkit/predicate';

isSymbol(Symbol('a')); // true
isSymbol(Symbol.for('a')); // true
isSymbol(Symbol.iterator); // true

isSymbol(null); // false
isSymbol(undefined); // false
isSymbol('123'); // false
isSymbol(false); // false
isSymbol(123n); // false
isSymbol({}); // false
isSymbol([1, 2, 3]); // false