带有厂商前缀的 API

在 Web 上,新的 API 在处于实验状态时通常带有厂商前缀。例如,在撰写本文时,AudioContext API 在 Safari 中被称为 webkitAudioContextvendor_prefix 属性指示这些替代名称,如果未定义正常名称,则会使用这些替代名称。

例如,要使用 AudioContext,你可以这样做:


# #![allow(unused_variables)]
#fn main() {
#[wasm_bindgen]
extern "C" {
    #[wasm_bindgen(vendor_prefix = webkit)]
    type AudioContext;

    // methods on `AudioContext` ...
}
#}

无论何时使用 AudioContext,如果全局命名空间定义了它,它将使用 AudioContext,或者它将回退到 webkitAudioContext

请注意,vendor_prefix 不能与 module = "..."js_namespace = ... 一起使用,因此它目前基本上仅限于 Web 平台 API。