skip_jsdoc
当附加到函数或方法时,会阻止 `wasm-bindgen` 自动生成 JSDoc 样式的文档注释。默认情况下,`wasm-bindgen` 会在生成的 JS 文件中的文档注释中添加 `@param` 和 `@returns` 注释。`skip_jsdoc` 注释会阻止这种情况,允许您提供自己的文档注释。
以下 rust 代码使用 `skip_jsdoc` 来省略一个自动生成的文档注释。
# #![allow(unused_variables)] #fn main() { use wasm_bindgen::prelude::*; /// Autogenerated docs. #[wasm_bindgen] pub fn foo(arg: u32) -> u32 { arg + 1 } /// Manually written docs. /// /// @param {number} arg - A descriptive description. /// @returns {number} Something a bit bigger. #[wasm_bindgen(skip_jsdoc)] pub fn bar(arg: u32) -> u32 { arg + 2 } #}
上面代码的 `wasm-bindgen` 生成的 JS 接口将类似于以下内容
/**
* Autogenerated docs.
*
* @param {number} arg
* @returns {number}
*/
export function foo(arg) { /* ... */ }
/**
* Manually written docs.
*
* @param {number} arg - A descriptive description.
* @returns {number} Something a bit bigger.
*/
export function bar(arg) { /* ... */ }