UNPKG

apify-client

Version:
71 lines 2.38 kB
import type { ApiClientSubResourceOptions } from '../base/api_client'; import { ResourceCollectionClient } from '../base/resource_collection_client'; import type { PaginatedIterator, PaginationOptions } from '../utils'; import type { Task, TaskUpdateData } from './task'; /** * Client for managing the collection of Actor tasks in your account. * * Tasks are pre-configured Actor runs with saved input and options. This client provides * methods to list and create tasks. * * @example * ```javascript * const client = new ApifyClient({ token: 'my-token' }); * const tasksClient = client.tasks(); * * // List all tasks * const { items } = await tasksClient.list(); * * // Create a new task * const newTask = await tasksClient.create({ * actId: 'my-actor-id', * name: 'my-task', * input: { url: 'https://example.com' } * }); * ``` * * @see https://docs.apify.com/platform/actors/running/tasks */ export declare class TaskCollectionClient extends ResourceCollectionClient { /** * @hidden */ constructor(options: ApiClientSubResourceOptions); /** * Lists all Tasks. * * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched * items in a single API call is limited. * ```javascript * const paginatedList = await client.list(options); * ``` * * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are * retrieved. * * ```javascript * for await (const singleItem of client.list(options)) {...} * ``` * * @param options - Pagination and sorting options. * @returns A paginated iterator of tasks. * @see https://docs.apify.com/api/v2/actor-tasks-get */ list(options?: TaskCollectionListOptions): PaginatedIterator<TaskList>; /** * Creates a new task. * * @param task - The task data. * @returns The created task object. * @see https://docs.apify.com/api/v2/actor-tasks-post */ create(task: TaskCreateData): Promise<Task>; } export interface TaskCollectionListOptions extends PaginationOptions { desc?: boolean; } export type TaskList = Omit<Task, 'options' | 'input'>; export interface TaskCreateData extends TaskUpdateData { actId: string; } //# sourceMappingURL=task_collection.d.ts.map