Skip to content

@gracious.tech/fetch-client


@gracious.tech/fetch-client / collection/generic / GenericCollection

Class: GenericCollection ​

Defined in: client/src/collection/generic.ts:123

Extended by ​

Constructors ​

Constructor ​

new GenericCollection(items, requester, languages, language2to3, languages_most_spoken, usage): GenericCollection

Defined in: client/src/collection/generic.ts:142

Parameters ​

items ​

Record<string, RuntimeManifestItem>

requester ​

RequestHandler

languages ​

Record<string, MetaLanguage>

language2to3 ​

Record<string, string>

languages_most_spoken ​

string[]

usage ​

UsageConfig

Returns ​

GenericCollection

Properties ​

requester ​

requester: RequestHandler

Defined in: client/src/collection/generic.ts:140

Methods ​

has_language() ​

has_language(language): boolean

Defined in: client/src/collection/generic.ts:181

Check if a language exists (must be 3 character id)

Parameters ​

language ​

string

Returns ​

boolean


has_resource() ​

has_resource(resource): boolean

Defined in: client/src/collection/generic.ts:186

Check if a resource exists

Parameters ​

resource ​

string

Returns ​

boolean


has_book() ​

has_book(resource, book): boolean

Defined in: client/src/collection/generic.ts:191

Check if a book exists within a resource

Parameters ​

resource ​

string

book ​

string

Returns ​

boolean


get_language() ​

get_language(code): GetLanguagesItem | undefined

Defined in: client/src/collection/generic.ts:199

Get a language’s metadata

Parameters ​

code ​

string

Returns ​

GetLanguagesItem | undefined


get_languages() ​

Call Signature ​

get_languages(options): Record<string, GetLanguagesItem>

Defined in: client/src/collection/generic.ts:215

Get available languages as either a list or an object

Parameters ​
options ​

ObjT<GetLanguagesOptions>

Returns ​

Record<string, GetLanguagesItem>

Call Signature ​

get_languages(options?): GetLanguagesItem[]

Defined in: client/src/collection/generic.ts:216

Get available languages as either a list or an object

Parameters ​
options? ​

ObjF<GetLanguagesOptions>

Returns ​

GetLanguagesItem[]


get_preferred_language() ​

get_preferred_language(preferences?): GetLanguagesItem

Defined in: client/src/collection/generic.ts:271

Get the user’s preferred available language (no arg required when used in browser)

Parameters ​

preferences? ​

string[] = []

Returns ​

GetLanguagesItem


get_resource() ​

get_resource(id): GetResourcesItem | undefined

Defined in: client/src/collection/generic.ts:303

Get a resource’s metadata

Parameters ​

id ​

string

Returns ​

GetResourcesItem | undefined


get_resources() ​

Call Signature ​

get_resources(options): Record<string, GetResourcesItem>

Defined in: client/src/collection/generic.ts:350

Get available resources as either a list or an object

Parameters ​
options ​

ObjT<GetResourcesOptions>

Returns ​

Record<string, GetResourcesItem>

Call Signature ​

get_resources(options?): GetResourcesItem[]

Defined in: client/src/collection/generic.ts:351

Get available resources as either a list or an object

Parameters ​
options? ​

ObjF<GetResourcesOptions>

Returns ​

GetResourcesItem[]


get_preferred_resource() ​

get_preferred_resource(languages?): GetResourcesItem

Defined in: client/src/collection/generic.ts:407

Get user’s preferred available resource (provide language preferences if not in browser)

Parameters ​

languages? ​

string[] = []

Returns ​

GetResourcesItem


get_books() ​

Call Signature ​

get_books(resource, options): Record<string, GetBooksItem>

Defined in: client/src/collection/generic.ts:455

Get which books are available for a resource. If no resource is given, all books will be listed but marked as unavailable. If fetch_translation_extras() has already been called for a translation then local name data will also be available (otherwise only English book names will be available).

Parameters ​
resource ​

string | undefined

options ​

ObjT<GetBooksOptions>

Returns ​

Record<string, GetBooksItem>

Call Signature ​

get_books(resource?, options?): GetBooksItem[]

Defined in: client/src/collection/generic.ts:457

Get which books are available for a resource. If no resource is given, all books will be listed but marked as unavailable. If fetch_translation_extras() has already been called for a translation then local name data will also be available (otherwise only English book names will be available).

Parameters ​
resource? ​

string

options? ​

ObjF<GetBooksOptions>

Returns ​

GetBooksItem[]


get_completion() ​

get_completion(resource): GetCompletionReturn

Defined in: client/src/collection/generic.ts:525

Get book ids that are available/missing for a resource for each testament

Parameters ​

resource ​

string

Returns ​

GetCompletionReturn