`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();
            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>');
            try {
                await puter.workers.get(workerName);
            } catch (e) {
                puter.print('Worker could not be retrieved<br>');
            }
        })();
    </script>
</body>
</html>

list()

create()

puter.workers.delete()