Struct JsString 

pub struct JsString(/* private fields */);

Invariant: Repr::Utf8 holds every well-formed value and Repr::Wtf16 only ill-formed ones (at least one unpaired surrogate). The derived PartialEq/Hash are only sound under this invariant: a well-formed value smuggled into Wtf16 would compare unequal to its Utf8 twin. The representation is private so the invariant holds by construction; match on JsString::as_ref to branch on well-formedness.

Implementations

impl JsString

pub fn from_code_units(units: Vec<u16>) -> Self

Build from UTF-16 code units, normalizing to UTF-8 when well-formed.

pub fn as_ref(&self) -> JsStringRef<'_>

pub fn as_str(&self) -> Option<&str>

The UTF-8 view, when the value is well-formed.

pub fn code_units(&self) -> Vec<u16>

pub fn len_utf16(&self) -> usize

Length in UTF-16 code units (JS String.prototype.length).

pub fn to_string_lossy(&self) -> String

The value with unpaired surrogates replaced by U+FFFD, for consumers whose string type cannot represent ill-formed values.

pub fn from_marker_string(s: &str) -> Self

Decode the bridge wire form: a UTF-8 string in which lone surrogates appear as __SURROGATE_XXXX__ markers (uppercase hex, mirroring what sanitizeJsonSurrogates emits and restoreJsonSurrogates accepts).

All scanning is byte-wise: a marker is 18 ASCII bytes, so byte-slice comparisons cannot land on a UTF-8 char boundary the way str range indexing can when multibyte text follows the prefix.

pub fn to_marker_string(&self) -> String

Encode to the bridge wire form (markers for unpaired surrogates).

pub fn to_escaped_string(&self) -> String

Render as JS-source-style escaped text, matching the form TS’s debug printer produces via JSON.stringify: unpaired surrogates print as lowercase \udXXX escapes inside the otherwise UTF-8 text.

Trait Implementations

impl Clone for JsString

fn clone(&self) -> JsString

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JsString

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for JsString

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for JsString

impl From<&str> for JsString

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for JsString

fn from(s: String) -> Self

Converts to this type from the input type.

impl Hash for JsString

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for JsString

fn eq(&self, other: &JsString) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<&str> for JsString

fn eq(&self, other: &&str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for JsString

fn eq(&self, other: &str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for JsString

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for JsString