使用 TextDecoder 和 TextEncoder 在 JavaScript 垃圾回收堆和 Wasm 线性内存之间来回复制字符串的内容。如果您不想执行此复制操作，而是希望使用 JavaScript 字符串值的句柄，请使用 js_sys::JsString 类型。

# #![allow(unused_variables)]
#fn main() {
use wasm_bindgen::prelude::*;

#[wasm_bindgen]
pub fn take_str_by_shared_ref(x: &str) {}

#}

import {
  take_str_by_shared_ref,
} from './guide_supported_types_examples';

take_str_by_shared_ref('hello');

JavaScript 中的字符串被编码为 UTF-16，但有一个主要例外：它们可以包含未配对的代理项。对于某些 Unicode 字符，UTF-16 使用两个 16 位值。这些被称为“代理对”，因为它们总是成对出现。在 JavaScript 中，这些代理对可能缺少另一半，从而创建一个“未配对的代理项”。

当从 JavaScript 传递字符串到 Rust 时，它使用 TextEncoder API 将 UTF-16 转换为 UTF-8。这通常是完全可以的……除非存在未配对的代理项。在这种情况下，它将用 U+FFFD (�，替换字符) 替换未配对的代理项。这意味着 Rust 中的字符串现在与 JavaScript 中的字符串不同了！

如果您想保证 Rust 字符串与 JavaScript 字符串相同，您应该使用 js_sys::JsString（它将字符串保留在 JavaScript 中，不会将其复制到 Rust）。

如果您想访问 JS 字符串的原始值，可以使用 JsString::iter，它返回一个 Iterator<Item = u16>。这完美地保留了所有内容（包括未配对的代理项），但它不执行任何编码（因此您必须自己执行！）。

如果您只是想忽略包含未配对代理项的字符串，可以使用 JsString::is_valid_utf16 来测试字符串是否包含未配对的代理项。