@enderdba/wwebjs-electron


> 🧠 This is a fork of wwebjs-electron adapted for deep integration inside Electron using puppeteer-core and BrowserView, without puppeteer-in-electron, it uses the exact same code for puppeteer-in-electron only with new dependencies.

✅ Features

- 🧩 100% compatible with whatsapp-web.js
- 🧠 No need for external Puppeteer installation: works with Electron’s built-in Chromium
- 🔐 Session management via persistent partition (BrowserView)
- 📦 Minimal dependencies, clean API

---

🚀 Installation

``bash
npm install @enderdba/wwebjs-electron puppeteer-core
`

> Note: You must be using Electron ≥ v17 and puppeteer-core (not full puppeteer) There's no need for it since it uses internal Electron built-in Chromium.

---

🧪 Example (Electron main process)

`ts
// main.ts
import { app, BrowserWindow, BrowserView } from 'electron';
import puppeteer from 'puppeteer-core';
import { Client, ElectronPuppeteer } from '@enderdba/wwebjs-electron';

let win: BrowserWindow;
let client: Client;

await ElectronPuppeteer.initialize(app); // ⬅️ MUST be before app.isReady()

app.whenReady().then(async () => {
const browser = await ElectronPuppeteer.connect(app, puppeteer);

win = new BrowserWindow({
width: 1200,
height: 800,
webPreferences: {
contextIsolation: true,
partition: 'persist:whatsapp_xxxx',
},
});

const view = new BrowserView({
webPreferences: {
contextIsolation: true,
partition: 'persist:whatsapp_xxxx',
},
});

win.setBrowserView(view);
view.setBounds({ x: 0, y: 0, width: 1200, height: 800 });
await view.webContents.loadURL('https://web.whatsapp.com');

client = new Client(browser, view, {
webVersionCache: { type: 'none' }
});

client.on('ready', () => console.log('✅ Client is ready!'));
client.on('message', msg => {
if (msg.body === '!ping') msg.reply('pong');
});

await client.initialize();
});
`

---

📌 Session Management

You do not need to use authentication strategies. Electron handles session storage via partition:

`ts
partition: 'persist:whatsapp-session_123'
`

Just assign a different partition per session and you're done.
You can save partitions in a JSON, SQLite, anywhere, just make sure you persist it somewhere.

---

💡 Advanced

- You can extract ClientInfo, Chat, Contact, Message and other classes directly from @enderdba/wwebjs-electron, just like in WWEBJS!.
- All whatsapp-web.js features are supported, including stickers, polls, buttons, and media.

---

📦 About this fork

This is a custom fork of wwebjs-electron, with some tweaks for:

- Eliminate puppeteer-in-electron dependency since it's integrated now.
- Improve support for BrowserView in multi-session contexts.
- Work reliably with puppeteer-core` and Electron's remote-debugging port.
- Integrate better with TypeScript.
- Doesn't close out the entire browser, just the page that renders Whatsapp.
Maintained by @enderdba

---

📄 License

Apache-2.0. See LICENSE

> WhatsApp is a trademark of WhatsApp Inc., and this project is not affiliated with them in any way.