docs(examples): add example with ES modules

examples/es-modules/README.md

@@ -0,0 +1,17 @@
+
+# Example with [ES modules](https://nodejs.org/api/esm.html)
+
+## How to use
+
+```
+# install the dependencies
+$ npm ci
+
+# start the server
+$ node server.js
+
+# start the client
+$ node client.js
+```
+
+You need Node.js `>=12.17.0`.

examples/es-modules/client.js

@@ -0,0 +1,18 @@
+import { Manager } from "socket.io-client";
+
+const manager = new Manager("ws://localhost:8080");
+const socket = manager.socket("/");
+
+socket.on("connect", () => {
+  console.log(`connect ${socket.id}`);
+});
+
+socket.on("disconnect", () => {
+  console.log(`disconnect`);
+});
+
+setInterval(() => {
+  socket.emit("ping", () => {
+    console.log("pong");
+  });
+}, 1000);

examples/es-modules/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "es-modules",
+  "version": "1.0.0",
+  "description": "An example with ES modules (https://nodejs.org/api/esm.html)",
+  "type": "module",
+  "author": "Damien Arrachequesne",
+  "license": "MIT",
+  "engines": {
+    "node": ">=12.17.0"
+  },
+  "dependencies": {
+    "socket.io": "beta",
+    "socket.io-client": "beta"
+  }
+}

examples/es-modules/server.js

@@ -0,0 +1,16 @@
+import { Server } from "socket.io";
+
+const io = new Server(8080);
+
+io.on("connect", (socket) => {
+  console.log(`connect ${socket.id}`);
+
+  socket.on("ping", (cb) => {
+    console.log("ping");
+    cb();
+  });
+
+  socket.on("disconnect", () => {
+    console.log(`disconnect ${socket.id}`);
+  });
+});