Reference / @open-music-sdk/client-user / getLibraryResources

Function: getLibraryResources()

function getLibraryResources(
   client, 
   ids, 
   options?
): Promise<tResourceCollectionResponse>;

Defined in: clients/client-user/src/library.ts:98

Library resources of several types in one request, by their ids: { "library-songs": [...] }. One type at least has to be given.

Parameters

client

tAppleMusicClient

The listener's client to ask with.

ids

Readonly<Partial<Record<tLibraryType, readonly string[] | undefined>>>

Ids by type of library resource: 1 to 32 types with 1 to 300 ids between them; a type whose list is undefined is left out.

options?

tLibraryResourcesOptions

What to send beside the resources.

Returns

Promise<tResourceCollectionResponse>

What Apple answered: the resources under data, of every type asked for.

Throws

TypeError if client is no client or an argument is not what it should be, before Apple is asked.

Throws

AppleMusicError if Apple, the network, or a token provider fails, or a schema finds issues; _tag says which.

Throws

The reason options.signal aborted with, when it does.

Throws

Whatever a token provider, store, schema, hook or rate limiter throws, as client.request passes it on.