Skip to main content

serde_v8/magic/
string_or_buffer.rs

1// Copyright 2018-2026 the Deno authors. MIT license.
2
3use std::ops::Deref;
4
5use super::buffer::JsBuffer;
6use super::transl8::FromV8;
7use crate::Error;
8use crate::magic::transl8::impl_magic;
9
10#[derive(Debug)]
11pub enum StringOrBuffer {
12  Buffer(JsBuffer),
13  String(String),
14}
15
16impl_magic!(StringOrBuffer);
17
18impl Deref for StringOrBuffer {
19  type Target = [u8];
20  fn deref(&self) -> &Self::Target {
21    match self {
22      Self::Buffer(b) => b.as_ref(),
23      Self::String(s) => s.as_bytes(),
24    }
25  }
26}
27
28impl<'a> TryFrom<&'a StringOrBuffer> for &'a str {
29  type Error = std::str::Utf8Error;
30  fn try_from(value: &'a StringOrBuffer) -> Result<Self, Self::Error> {
31    match value {
32      StringOrBuffer::String(s) => Ok(s.as_str()),
33      StringOrBuffer::Buffer(b) => std::str::from_utf8(b.as_ref()),
34    }
35  }
36}
37
38impl FromV8 for StringOrBuffer {
39  fn from_v8<'scope, 'i>(
40    scope: &mut v8::PinScope<'scope, 'i>,
41    value: v8::Local<'scope, v8::Value>,
42  ) -> Result<Self, crate::Error> {
43    match JsBuffer::from_v8(scope, value) {
44      Ok(buf) => {
45        return Ok(Self::Buffer(buf));
46      }
47      _ => {
48        if let Ok(s) = crate::from_v8(scope, value) {
49          return Ok(Self::String(s));
50        }
51      }
52    }
53    Err(Error::ExpectedBuffer(value.type_repr()))
54  }
55}