Database

Struct Database 

Source
pub struct Database(/* private fields */);
Expand description

An IDBDatabase implementation.

Implementations§

Source§

impl Database

Source

pub fn open<N>(name: N) -> OpenDbRequestBuilder<N>
where N: AsRef<str>,

Open a database with the given name. Convenience method for OpenDbRequestBuilder::new - use it when opening multiple databases.

§Errors
ErrorThrown when
InvalidStateErrorThrown if the method was not called from a Versionchange transaction callback.
TransactionInactiveErrorThrown if a request is made on a source database that does not exist (for example, when the database has been deleted or removed).
ConstraintErrorThrown if an object store with the given name (based on a case-sensitive comparison) already exists in the connected database.
InvalidAccessErrorThrown if autoIncrement is set to true and keyPath is either an empty string or an array containing an empty string.
Source

pub fn create_object_store<N>(&self, name: N) -> StoreBuilder<'_, N>
where N: AsRef<str>,

Create an object store with the given name.

Source

pub fn close(self)

Close the database connection in a background thread.

Source

pub fn delete(self) -> Result<Request<()>, OpenDbError>

Close and delete the database.

§Errors

Undocumented as of the release of this version.

Source

pub fn delete_object_store(&self, name: &str) -> Result<(), Error>

Delete the object store with the given name.

§Errors
ErrorThrown when
InvalidStateErrorThrown if the method was not called from a Versionchange transaction callback.
TransactionInactiveErrorThrown if a request is made on a source database that does not exist (for example, when the database has been deleted or removed).
NotFoundErrorThrown when trying to delete an object store that does not exist.
Source

pub fn name(&self) -> String

Get the database name.

Source

pub fn object_store_names(&self) -> DomStringIter<'_>

List the names of the object stores within this database.

Source

pub fn transaction<S>(&self, store_names: S) -> TransactionBuilder<'_, S>
where S: ObjectStoreName,

Start a transaction on the given store name(s). Finish the builder with a call to Build::build.

§Errors
ErrorThrown when
NotFoundErrorThrown if an object store specified cannot be found.
InvalidAccessErrorThrown if the fn was called with an empty list of store names.
Source

pub fn version(&self) -> f64

Get the database version.

Source

pub fn delete_by_name(name: &str) -> Result<Request<()>, OpenDbError>

Delete the database with the given name. Convenience method for DBFactory::delete_db - use that if you need to delete more than one database.

§Errors

Undocumented as of the release of this version.

Trait Implementations§

Source§

impl Clone for Database

Source§

fn clone(&self) -> Database

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Database

Source§

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

Formats the value using the given formatter. Read more
Source§

impl SystemRepr for Database

Source§

type Repr = DbSys

Internal web_sys-based representation type.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V