如何使用 JSDoc 在 javascript 中转换 TypeScript 类型

当使用 TypeScript 检查 JavaScript 代码时，如何转换为与推断不同的类型？打字稿有<Type> and as Type语法，但这些在 JavaScript 中无效。

/**
 * @param {{id: string, value: number}} details - object with required properties
 */
function stringifyObject(details) {
  return `${details.id}: ${details.value}`;
}

const testValue = {id: 'no-value'};
stringifyObject(testValue); // want to cast testValue to ignore missing property
stringifyObject(/** @type {any} */ testValue); // this doesn't work

The /** @type */评论很接近。根据TypeScript 手册 https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#casts它只需要在被转换的值周围加上括号。

TypeScript 借用了 Google Closure 的强制转换语法。这允许您通过添加一个类型将类型转换为其他类型@type tag 在任何带括号的表达式之前.

因此，在最初的示例中，您将编写以下内容：

// Wrap value being cast in parenthesis 
stringifyObject(/** @type {any} */ (testValue));