Class: Items

repositories.Items

Items repository.

The Items class allows you to manage items in datasets.

Hierarchy

• Repository

  ↳ Items

Implements

• IBundle < SDKItem >

Table of contents

Constructors

• constructor

Methods

• create
• delete
• fetch
• get
• query
• stream
• update

Constructors

constructor

• new Items(agent)

Creates an instance of Repository.

Parameters

Inherited from

Repository .constructor

Methods

create

▸ create(payload): Promise<SDKItem>

Creates a new item in the Items repository.

Example

const file = new File(['content'], 'filename.txt', { type: 'text/plain' })
const binariesItemPayload = {
    file: file,
    path: 'path/to/item',
    metadata: {
        key: 'value'
    },
    binaries: true
}

const item = await sdk.items.create(binariesItemPayload)

Parameters

Returns

Promise<SDKItem>

• A promise that resolves with the created item.

delete

▸ delete(payload?): Promise<void>

Deletes an item from the repository. If the itemId is not provided, the active itemId is used. If the datasetId is not provided, the active datasetId is used.

Example

// delete an item with ID 'item1' in dataset with ID 'dataset1'
await dl.items.delete({ itemId: 'item1', datasetId: 'dataset1' });

Parameters

Returns

Promise<void>

• A promise that resolves once the item is deleted.

Implementation of

IBundle.delete

fetch

▸ fetch(id?): Promise<any>

Fetches the raw contents of an item by id. When the id is not provided, it uses the active item.

Example

// Given a text file with the contents "hello world"
const rawItem = await dl.items.fetch('a-txt-file-id')
console.log(rawItem)
// logs: "hello world"

Parameters

Returns

Promise<any>

• A promise that resolves to the content data.

Implementation of

IBundle.fetch

get

▸ get(id?): Promise<SDKItem>

Gets an item by id. When the id is not provided, it returns the active item.

Example

const activeItem = await dl.items.get()

Example

const item = await dl.items.get('item-id-123')

Parameters

Returns

Promise<SDKItem>

• A promise that resolves to the item data.

Implementation of

IBundle.get

query

▸ query(payload?): Promise<IPagedResponse<SDKItem>>

Lists all items by filter. When no payload is provided, it returns all the items in the active dataset.

Example

const pagedResponse = await dl.items.query()
const itemsArray = pagedResponse.items

Parameters

Returns

Promise<IPagedResponse<SDKItem>>

• Returns a Promise that resolves to a paged response object of items.

Implementation of

IBundle.query

stream

▸ stream(url?): Promise<string>

Retrieves the stream of an item by an item's stream URL.

Example

const stream = await dl.items.stream('https://gate.dataloop.ai/api/v1/items/item-id/stream')

Parameters

Returns

Promise<string>

• A promise that resolves to the stream's string.

Implementation of

IBundle.stream

update

▸ update(fieldsToUpdate): Promise<SDKItem>

Update an existing item.

Example

const updatedItem = await dl.items.update({
    id: "item-1",
    name: "Updated item name"
})

Parameters

Returns

Promise<SDKItem>

• The updated item.

Implementation of

IBundle.update

Note: To update the system object in metadata field, one needs to pass system: true in the updated item object.

Example

const updatedItem = await dl.items.update({
    id: "item-1",
    name: "Updated item name",
    system: true,
    metadata: {
       system: {
           audioSpeakers: { "Label 1": "Label 1 New Value" } 
       }
    }
})

In this example, we are updating audioSpeakers value of the system object by passing system: true at the top level of the updated item object.