Skip to content

BlockSuite API Documentation / @blocksuite/store / DocCollection

Class: DocCollection

Extends

  • DocCollectionAddonType

Constructors

new DocCollection()

new DocCollection(__namedParameters): DocCollection

Parameters

__namedParameters: DocCollectionOptions

Returns

DocCollection

Overrides

DocCollectionAddonType.constructor

Defined in

packages/framework/store/src/store/collection.ts:127

Properties

_schema

protected readonly _schema: Schema

Defined in

packages/framework/store/src/store/collection.ts:78


awarenessStore

readonly awarenessStore: AwarenessStore<BlockSuiteFlags>

Defined in

packages/framework/store/src/store/collection.ts:80


awarenessSync

readonly awarenessSync: AwarenessEngine

Defined in

packages/framework/store/src/store/collection.ts:82


blobSync

readonly blobSync: BlobEngine

Defined in

packages/framework/store/src/store/collection.ts:84


blockCollections

readonly blockCollections: Map<string, BlockCollection>

Defined in

packages/framework/store/src/store/collection.ts:86


doc

readonly doc: BlockSuiteDoc

Defined in

packages/framework/store/src/store/collection.ts:88


docSync

readonly docSync: DocEngine

Defined in

packages/framework/store/src/store/collection.ts:90


exportJSX()

exportJSX: (blockId?, docId?) => JSXElement

Parameters

blockId?: string

docId?: string

Returns

JSXElement

Inherited from

DocCollectionAddonType.exportJSX

Defined in

packages/framework/store/src/store/addon/type.ts:4


id

readonly id: string

Defined in

packages/framework/store/src/store/collection.ts:92


idGenerator

readonly idGenerator: IdGenerator

Defined in

packages/framework/store/src/store/collection.ts:94


importDocSnapshot()

importDocSnapshot: (json, docId) => Promise<void>

Parameters

json: unknown

docId: string

Returns

Promise<void>

Inherited from

DocCollectionAddonType.importDocSnapshot

Defined in

packages/framework/store/src/store/addon/type.ts:6


meta

meta: DocCollectionMeta

Defined in

packages/framework/store/src/store/collection.ts:96


slots

slots: object

docAdded

docAdded: Slot<string>

docCreated

docCreated: Slot<string>

docRemoved

docRemoved: Slot<string>

docUpdated

docUpdated: Slot<void>

Defined in

packages/framework/store/src/store/collection.ts:98


Y

static Y: __module

Defined in

packages/framework/store/src/store/collection.ts:76

Accessors

docs

get docs(): Map<string, BlockCollection>

Returns

Map<string, BlockCollection>

Defined in

packages/framework/store/src/store/collection.ts:105


isEmpty

get isEmpty(): boolean

Returns

boolean

Defined in

packages/framework/store/src/store/collection.ts:109


schema

get schema(): Schema

Returns

Schema

Defined in

packages/framework/store/src/store/collection.ts:123

Methods

canGracefulStop()

canGracefulStop(): void

Verify that all data has been successfully saved to the primary storage. Return true if the data transfer is complete and it is secure to terminate the synchronization operation.

Returns

void

Defined in

packages/framework/store/src/store/collection.ts:205


createDoc()

createDoc(options): Doc

By default, only an empty doc will be created. If the init parameter is passed, a surface, note, and paragraph block will be created in the doc simultaneously.

Parameters

options = {}

options.id?: string

options.query?: Query

Returns

Doc

Defined in

packages/framework/store/src/store/collection.ts:214


forceStop()

forceStop(): void

Terminate the data sync process forcefully, which may cause data loss. It is advised to invoke canGracefulStop before calling this method.

Returns

void

Defined in

packages/framework/store/src/store/collection.ts:237


getBlockCollection()

getBlockCollection(docId): null | BlockCollection

Parameters

docId: string

Returns

null | BlockCollection

Defined in

packages/framework/store/src/store/collection.ts:243


getDoc()

getDoc(docId, options?): null | Doc

Parameters

docId: string

options?: GetDocOptions

Returns

null | Doc

Defined in

packages/framework/store/src/store/collection.ts:248


removeDoc()

removeDoc(docId): void

Parameters

docId: string

Returns

void

Defined in

packages/framework/store/src/store/collection.ts:253


setDocMeta()

setDocMeta(docId, props): void

Update doc meta state. Note that this intentionally does not mutate doc state.

Parameters

docId: string

props: Partial<DocMeta>

Returns

void

Defined in

packages/framework/store/src/store/collection.ts:271


start()

start(): void

Start the data sync process

Returns

void

Defined in

packages/framework/store/src/store/collection.ts:282


waitForGracefulStop()

waitForGracefulStop(abort?): Promise<void>

Wait for all data has been successfully saved to the primary storage.

Parameters

abort?: AbortSignal

Returns

Promise<void>

Defined in

packages/framework/store/src/store/collection.ts:291


waitForSynced()

waitForSynced(): Promise<unknown>

Returns

Promise<unknown>

Defined in

packages/framework/store/src/store/collection.ts:295