Struct Root 

pub struct Root(pub(crate) FileSystemDirectoryHandle);

The origin’s private directory: where a browser keeps this app’s containers, and the only place it keeps them.

Tuple Fields

0: FileSystemDirectoryHandle

Implementations

impl Root

pub async fn open() -> Result<Self>

Errors

A page with no origin-private storage — which is every page that is not a secure context.

pub async fn container(&self, name: &Name, missing: Missing) -> Result<Opfs>

The container called name, made if it is not there and missing says so.

A directory, not a document: whether what stands there is a container is what Store::opening answers.

Errors

std::io::ErrorKind::NotFound for a name nothing stands under and nothing is to be made, or the browser’s refusal.

pub async fn containers(&self) -> Result<Vec<Name>>

Every container in the origin, by name and in name order — the library’s list.

A directory holding a manifest is what counts as one, so a folder something else in the origin made is not offered as a document.

Errors

The browser’s refusal.

pub async fn holds(&self, name: &Name) -> Result<bool>

Whether anything already stands under name — what a new document and a rename each ask before they take one.

Errors

The browser’s refusal.

pub async fn remove(&self, name: &Name) -> Result<()>

Remove a container and everything in it — the library’s delete, where Opfs::discard is the store’s own and takes only an emptied one.

Errors

std::io::ErrorKind::NotFound for a name nothing stands under, or the browser’s refusal.

pub async fn remove_unheld(&self, name: &Name) -> Result<()>

Remove a container no view holds. Its lock is claimed first and kept until the directory is gone, so a container open in another tab is refused rather than pulled out from under the session writing it.

Errors

std::io::ErrorKind::ResourceBusy for a container another view holds, and otherwise as Self::remove.

Trait Implementations

impl Clone for Root

fn clone(&self) -> Root

Returns a duplicate of the value.

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

Performs copy-assignment from source.