From b6d0cbcf20d893d60d34d205da3866fddb47e506 Mon Sep 17 00:00:00 2001
From: Jesse Cogollo <cogollo87@gmail.com>
Date: Fri, 21 Jun 2019 17:03:37 -0500
Subject: [PATCH] doc: add example code for worker.isDead() to cluster.md

PR-URL: https://github.com/nodejs/node/pull/28362
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
---
 doc/api/cluster.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/doc/api/cluster.md b/doc/api/cluster.md
index e72bf8f7f7db02..a3dc1239aa8b9f 100644
--- a/doc/api/cluster.md
+++ b/doc/api/cluster.md
@@ -381,6 +381,41 @@ added: v0.11.14
 This function returns `true` if the worker's process has terminated (either
 because of exiting or being signaled). Otherwise, it returns `false`.
 
+```js
+const cluster = require('cluster');
+const http = require('http');
+const numCPUs = require('os').cpus().length;
+
+if (cluster.isMaster) {
+  console.log(`Master ${process.pid} is running`);
+
+  // Fork workers.
+  for (let i = 0; i < numCPUs; i++) {
+    cluster.fork();
+  }
+
+  cluster.on('fork', (worker) => {
+    console.log('worker is dead:', worker.isDead());
+  });
+
+  cluster.on('exit', (worker, code, signal) => {
+    console.log('worker is dead:', worker.isDead());
+  });
+
+} else {
+  // Workers can share any TCP connection
+  // In this case it is an HTTP server
+  http.createServer((req, res) => {
+    res.writeHead(200);
+    res.end(`Current process\n ${process.pid}`);
+    process.kill(process.pid);
+  }).listen(8000);
+
+  // Make http://localhost:8000 to ckeck isDead method.
+}
+
+```
+
 ### worker.kill([signal='SIGTERM'])
 <!-- YAML
 added: v0.9.12