Inform RStudio's Background Jobs pane that a job has been added.
jobAdd(
name,
status = "",
progressUnits = 0L,
actions = NULL,
running = FALSE,
autoRemove = TRUE,
show = TRUE
)
An ID representing the newly added job, used as a handle to provide further updates of the job's status.
The background job's name.
The initial status text for the job; optional.
The integer number of units of work in the job; for
example, 100L
if the job's progress is expressed in percentages. Use
0L
if the number of units of work is unknown.
A list of actions that can be performed on the job (see Actions).
Whether the job is currently running.
Whether to remove the job from the Background Jobs pane when it's complete.
Whether to show the job in the Jobs pane.
The actions
parameter is a named list of functions that the user can
invoke on the job; for example: actions = list(stop = function(id) {
... })
. The function will be passed a parameter named id
with the
job ID that invoked it.
There are three special action names:
If there is an
action named stop
, then the job will have a Stop button in in the
Jobs pane, and pressing that button will invoke the stop
action.
If there is an action named info
, then the job will have
an informational link in the Background Jobs pane rather than an output display,
and clicking the link will invoke the info
action.
If there is an action named replay
, then the job will
have a Replay button that displays when the job has finished running. Clicking
the button will invoke the replay
action.
Other jobs: jobAddOutput()
,
jobAddProgress()
, jobRemove()
,
jobRunScript()
, jobSetProgress()
,
jobSetState()
, jobSetStatus()