Queue client signatures
The queue client signatures the Node.js SDK declares, straight from its own declarations.
The queue client signatures the Node.js SDK declares, straight from its own declarations.
Signatures, parameters, defaults and return types come straight from the declarations, so they cannot drift from the code. Prose, examples and gotchas live on the hand-written pages this section sits beside.
Generated from sdks/node/native/index.d.ts.
reservedSettingPrefixes()reservedSettingPrefixes(): Array<string>queue.ackMessage()queue.ackMessage(
topic: string,
subscriptionName: string,
messageId: string
): Promise<boolean>queue.ackTopicCursor()queue.ackTopicCursor(
topic: string,
subscriptionName: string,
cursor: string
): Promise<boolean>queue.acquireLock()queue.acquireLock(name: string, ownerId: string, ttlMs: number): booleanqueue.cancelJob()queue.cancelJob(id: string): booleanqueue.cascadeSkipPending()queue.cascadeSkipPending(runId: string): voidqueue.checkFanOutCompletion()queue.checkFanOutCompletion(
runId: string,
parentNodeName: string
): JsFanOutCompletion | nullqueue.closeDashboardAudit()queue.closeDashboardAudit(): Promise<void>queue.compensationNodeForJob()queue.compensationNodeForJob(jobId: string): JsWorkflowNodeRef | nullqueue.countPendingByQueue()queue.countPendingByQueue(queue: string): numberqueue.createDeferredJob()queue.createDeferredJob(
runId: string,
nodeName: string,
payload: Buffer,
taskName: string,
queue: string,
maxRetries: number,
timeoutMs: number,
priority: number
): stringqueue.deadLetters()queue.deadLetters(
limit?: number | undefined | null,
offset?: number | undefined | null
): Promise<Array<JsDeadJob>>queue.deadLettersAfter()queue.deadLettersAfter(
limit?: number | undefined | null,
after?: string | undefined | null
): Promise<JsDeadJobPage>queue.deadLettersByTask()queue.deadLettersByTask(
taskName: string,
limit?: number | undefined | null,
offset?: number | undefined | null
): Promise<Array<JsDeadJob>>queue.declareTopic()queue.declareTopic(
name: string,
mode: string,
retentionMs?: number | undefined | null
): Promise<void>queue.deleteDead()queue.deleteDead(deadId: string): booleanqueue.deletePeriodic()queue.deletePeriodic(name: string): booleanqueue.deleteSetting()queue.deleteSetting(key: string): booleanqueue.dryRunRetention()queue.dryRunRetention(
retention?: RetentionInput | undefined | null
): Promise<string>queue.effectiveRetention()queue.effectiveRetention(): string | nullqueue.enqueue()queue.enqueue(
taskName: string,
payload: Buffer,
options?: EnqueueOptions | undefined | null
): stringqueue.enqueueCompensation()queue.enqueueCompensation(
runId: string,
nodeName: string,
payload: Buffer,
taskName: string,
queue: string,
maxRetries: number,
timeoutMs: number,
priority: number
): stringqueue.enqueueMany()queue.enqueueMany(
taskName: string,
jobs: Array<EnqueueJob>
): Array<string>queue.expandFanOut()queue.expandFanOut(
runId: string,
parentNodeName: string,
childNames: Array<string>,
childPayloads: Array<Buffer>,
taskName: string,
queue: string,
maxRetries: number,
timeoutMs: number,
priority: number
): Array<string>queue.extendLock()queue.extendLock(name: string, ownerId: string, ttlMs: number): booleanqueue.finalizeRunIfTerminal()queue.finalizeRunIfTerminal(runId: string): string | nullqueue.getJob()queue.getJob(id: string): JsJob | nullqueue.getJobErrors()queue.getJobErrors(jobId: string): Promise<Array<JsJobError>>queue.getLockInfo()queue.getLockInfo(name: string): JsLockInfo | nullqueue.getMetrics()queue.getMetrics(
task: string | undefined | null,
sinceMs: number
): Promise<Array<JsMetric>>queue.getReplayHistory()queue.getReplayHistory(jobId: string): Promise<Array<JsReplayEntry>>queue.getSetting()queue.getSetting(key: string): string | nullqueue.getTaskLogs()queue.getTaskLogs(jobId: string): Array<JsTaskLog>queue.getTaskLogsAfter()queue.getTaskLogsAfter(
jobId: string,
afterId?: string | undefined | null
): Array<JsTaskLog>queue.getWorkflowChildren()queue.getWorkflowChildren(runId: string): Array<JsWorkflowRun>queue.getWorkflowDag()queue.getWorkflowDag(runId: string): string | nullqueue.getWorkflowNodes()queue.getWorkflowNodes(runId: string): Array<JsWorkflowNode>queue.getWorkflowRun()queue.getWorkflowRun(runId: string): JsWorkflowRun | nullqueue.getWorkflowRunPlan()queue.getWorkflowRunPlan(runId: string): JsWorkflowRunPlan | nullqueue.isCancelRequested()queue.isCancelRequested(id: string): booleanqueue.jobDag()queue.jobDag(jobId: string): Promise<JsJobDag>queue.leaseTopicMessages()queue.leaseTopicMessages(
topic: string,
subscriptionName: string,
limit: number,
visibilityMs: number
): Promise<Array<JsTopicMessage>>queue.listArchived()queue.listArchived(
limit?: number | undefined | null,
offset?: number | undefined | null
): Promise<Array<JsJob>>queue.listArchivedAfter()queue.listArchivedAfter(
limit?: number | undefined | null,
after?: string | undefined | null
): Promise<JsJobPage>queue.listCircuitBreakers()queue.listCircuitBreakers(): Promise<Array<JsCircuitBreaker>>queue.listDeclaredTopics()queue.listDeclaredTopics(): Promise<Array<JsTopic>>queue.listJobs()queue.listJobs(
filter?: JobFilter | undefined | null
): Promise<Array<JsJob>>queue.listJobsAfter()queue.listJobsAfter(
filter?: JobFilter | undefined | null,
after?: string | undefined | null
): Promise<JsJobPage>queue.listJobsFiltered()queue.listJobsFiltered(
filter?: DetailedJobFilter | undefined | null
): Promise<Array<JsJob>>queue.listJobsFilteredAfter()queue.listJobsFilteredAfter(
filter?: DetailedJobFilter | undefined | null,
after?: string | undefined | null
): Promise<JsJobPage>queue.listPausedQueues()queue.listPausedQueues(): Array<string>queue.listPeriodic()queue.listPeriodic(): Array<JsPeriodicTask>queue.listSettings()queue.listSettings(): Record<string, string>queue.listSubscriptions()queue.listSubscriptions(
topic?: string | undefined | null
): Promise<Array<JsSubscription>>queue.listWorkers()queue.listWorkers(): Promise<Array<JsWorkerRow>>queue.listWorkflowRuns()queue.listWorkflowRuns(
definitionName?: string | undefined | null,
state?: string | undefined | null,
limit?: number | undefined | null,
offset?: number | undefined | null
): Array<JsWorkflowRun>queue.markWorkflowNodeResult()queue.markWorkflowNodeResult(
jobId: string,
succeeded: boolean,
error?: string | undefined | null,
skipCascade?: boolean | undefined | null
): JsWorkflowAdvance | nullqueue.migrate()queue.migrate(): Promise<MigrationSummary>queue.minContract()queue.minContract(): numberqueue.nackMessage()queue.nackMessage(
topic: string,
subscriptionName: string,
messageId: string
): Promise<boolean>JsQueue.open()JsQueue.open(options: OpenOptions): JsQueuequeue.pauseQueue()queue.pauseQueue(queue: string): voidqueue.publish()queue.publish(
topic: string,
payload: Buffer,
options?: PublishOptions | undefined | null
): Promise<Array<JsJob>>queue.purgeCompleted()queue.purgeCompleted(olderThanMs: number): Promise<number>queue.purgeDead()queue.purgeDead(olderThanMs: number): Promise<number>queue.purgeDeadByTask()queue.purgeDeadByTask(taskName: string): Promise<number>queue.queryTaskLogs()queue.queryTaskLogs(
taskName: string | undefined | null,
level: string | undefined | null,
sinceMs: number,
limit: number
): Promise<Array<JsTaskLog>>queue.readTopicMessages()queue.readTopicMessages(
topic: string,
subscriptionName: string,
limit: number
): Promise<Array<JsTopicMessage>>queue.reapEphemeralSubscriptions()queue.reapEphemeralSubscriptions(
workerId?: string | undefined | null
): Promise<number>queue.recordDashboardAction()queue.recordDashboardAction(
method: string,
path: string,
status: number,
username?: string | undefined | null
): voidqueue.registerPeriodic()queue.registerPeriodic(
name: string,
taskName: string,
cronExpr: string,
args?: Buffer | undefined | null,
queue?: string | undefined | null,
timezone?: string | undefined | null,
enabled?: boolean | undefined | null
): numberqueue.registerSubscription()queue.registerSubscription(
topic: string,
subscriptionName: string,
taskName: string,
queue: string,
durable: boolean,
ownerWorkerId?: string | undefined | null,
priority?: number | undefined | null,
maxRetries?: number | undefined | null,
timeoutMs?: number | undefined | null,
mode?: string | undefined | null
): Promise<void>queue.releaseLock()queue.releaseLock(name: string, ownerId: string): booleanqueue.replayJob()queue.replayJob(jobId: string): Promise<string>queue.requestCancel()queue.requestCancel(id: string): booleanqueue.requestWorkerDrain()queue.requestWorkerDrain(workerId: string): booleanqueue.requeueJob()queue.requeueJob(jobId: string): booleanqueue.resolveWorkflowGate()queue.resolveWorkflowGate(
runId: string,
nodeName: string,
approved: boolean,
error?: string | undefined | null
): voidqueue.resumeQueue()queue.resumeQueue(queue: string): voidqueue.retryDead()queue.retryDead(deadId: string): stringqueue.runWorker()queue.runWorker(
callback: ((arg: JsTaskInvocation) => Promise<JsTaskOutcome>),
outcomeCallback: ((arg: JsOutcome) => unknown),
options?: WorkerOptions | undefined | null
): JsWorkerqueue.setMinContract()queue.setMinContract(level: number): voidqueue.setPeriodicEnabled()queue.setPeriodicEnabled(name: string, enabled: boolean): booleanqueue.setSetting()queue.setSetting(key: string, value: string): voidqueue.setSettingIf()queue.setSettingIf(
key: string,
expected: string | undefined | null,
value: string
): booleanqueue.setSubscriptionActive()queue.setSubscriptionActive(
topic: string,
subscriptionName: string,
active: boolean
): Promise<boolean>queue.setWorkflowNodeCompensated()queue.setWorkflowNodeCompensated(
runId: string,
nodeName: string,
completedAt: number
): voidqueue.setWorkflowNodeCompensationFailed()queue.setWorkflowNodeCompensationFailed(
runId: string,
nodeName: string,
error: string,
completedAt: number
): voidqueue.setWorkflowNodeRunning()queue.setWorkflowNodeRunning(runId: string, nodeName: string): voidqueue.setWorkflowNodeWaitingApproval()queue.setWorkflowNodeWaitingApproval(
runId: string,
nodeName: string
): voidqueue.setWorkflowRunState()queue.setWorkflowRunState(
runId: string,
state: string,
error?: string | undefined | null,
completedAt?: number | undefined | null
): voidqueue.skipWorkflowNode()queue.skipWorkflowNode(runId: string, nodeName: string): voidqueue.startDashboardAudit()queue.startDashboardAudit(retentionDays: number): voidqueue.stats()queue.stats(): Promise<JsStats>queue.statsAllQueues()queue.statsAllQueues(): Promise<Record<string, JsStats>>queue.statsByQueue()queue.statsByQueue(queue: string): Promise<JsStats>queue.submitWorkflow()queue.submitWorkflow(
name: string,
version: number,
dagBytes: Buffer,
stepMetadataJson: string,
nodePayloads: Record<string, Buffer>,
queueDefault?: string | undefined | null,
paramsJson?: string | undefined | null,
deferredNodeNames?: Array<string> | undefined | null,
parentRunId?: string | undefined | null,
parentNodeName?: string | undefined | null,
traceparent?: string | undefined | null,
tracestate?: string | undefined | null
): stringqueue.supportsSteps()queue.supportsSteps(): booleanqueue.topicBacklogStats()queue.topicBacklogStats(): Promise<Array<JsTopicStat>>queue.topicLogStats()queue.topicLogStats(): Promise<Array<JsTopicLogStat>>queue.unsubscribe()queue.unsubscribe(
topic: string,
subscriptionName: string
): Promise<boolean>queue.updateProgress()queue.updateProgress(id: string, progress: number): voidqueue.workerHeartbeat()queue.workerHeartbeat(
workerId: string,
resourceHealth?: string | undefined | null
): Promise<JsHeartbeat>queue.workflowNodeForJob()queue.workflowNodeForJob(jobId: string): JsWorkflowNodeRef | nullqueue.writeTaskLog()queue.writeTaskLog(
jobId: string,
taskName: string,
level: string,
message: string,
extra?: string | undefined | null
): void