puter.workers.delete()


Deletes an existing worker and stops its execution.

Syntax

puter.workers.delete(workerName)

Parameters

workerName (String)(Required)

The name of the worker to delete.

Return Value

A Promise that resolves to true if successful, or throws an Error if the operation fails.

Examples

Basic Worker Deletion

<html>
<body>
    <script src="https://js.puter.com/v2/"></script>
    <script>
        (async () => {
            // (1) Create a random worker
            let workerName = puter.randName();
            await puter.fs.write('example-worker.js')
            const worker = await puter.workers.create(workerName, 'example-worker.js')
            puter.print(`Worker deployed at: ${worker.url} (This is an empty worker with no code)<br>`);

            // (2) Delete the worker using delete()
            const worker2 = await puter.workers.delete(workerName);
            puter.print('Worker deleted<br>');

            // (3) Try to retrieve the worker (should fail)
            puter.print('Trying to retrieve worker... (should fail)<br>');
            const workerInfo = await puter.workers.get(workerName);
            if (workerInfo) {
                puter.print("Worker found (not deleted)!")
            } else {
                puter.print('Worker could not be retrieved<br>');
            }
        })();
    </script>
</body>
</html>