Struct worker_plus::Bucket

pub struct Bucket { /* private fields */ }

An instance of the R2 bucket binding.

Implementations

impl Bucket

pub async fn head(&self, key: impl Into<String>) -> Result<Option<Object>>

Retrieves the Object for the given key containing only object metadata, if the key exists.

pub fn get(&self, key: impl Into<String>) -> GetOptionsBuilder<'_>

Retrieves the Object for the given key containing object metadata and the object body if the key exists. In the event that a precondition specified in options fails, get() returns an Object with no body.

pub fn put(
    &self,
    key: impl Into<String>,
    value: impl Into<Data>
) -> PutOptionsBuilder<'_>

Stores the given value and metadata under the associated key. Once the write succeeds, returns an Object containing metadata about the stored Object.

R2 writes are strongly consistent. Once the future resolves, all subsequent read operations will see this key value pair globally.

pub async fn delete(&self, key: impl Into<String>) -> Result<()>

Deletes the given value and metadata under the associated key. Once the delete succeeds, returns void.

R2 deletes are strongly consistent. Once the Promise resolves, all subsequent read operations will no longer see this key value pair globally.

pub fn list(&self) -> ListOptionsBuilder<'_>

Returns an Objects containing a list of Objectss contained within the bucket. By default, returns the first 1000 entries.

Trait Implementations

impl AsRef<JsValue> for Bucket

fn as_ref(&self) -> &JsValue

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for Bucket

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

Formats the value using the given formatter.

impl From<Bucket> for JsValue

fn from(bucket: Bucket) -> Self

Converts to this type from the input type.

impl JsCast for Bucket

fn instanceof(val: &JsValue) -> bool

Performs a dynamic instanceof check to see whether the JsValue provided is an instance of this type.

fn unchecked_from_js(val: JsValue) -> Self

Performs a zero-cost unchecked conversion from a JsValue into an instance of Self

fn unchecked_from_js_ref(val: &JsValue) -> &Self

Performs a zero-cost unchecked conversion from a &JsValue into an instance of &Self.

fn has_type<T>(&self) -> boolwhere
    T: JsCast,

Test whether this JS value has a type T.

fn dyn_into<T>(self) -> Result<T, Self>where
    T: JsCast,

Performs a dynamic cast (checked at runtime) of this value into the target type T.

fn dyn_ref<T>(&self) -> Option<&T>where
    T: JsCast,

Performs a dynamic cast (checked at runtime) of this value into the target type T.

fn unchecked_into<T>(self) -> Twhere
    T: JsCast,

Performs a zero-cost unchecked cast into the specified type.

fn unchecked_ref<T>(&self) -> &Twhere
    T: JsCast,

Performs a zero-cost unchecked cast into a reference to the specified type.

fn is_instance_of<T>(&self) -> boolwhere
    T: JsCast,

Test whether this JS value is an instance of the type T.

fn is_type_of(val: &JsValue) -> bool

Performs a dynamic check to see whether the JsValue provided is a value of this type.