Skip to content

Allow the renderer to get information about the version of Electron, Chrome and NodeJS used

License

Notifications You must be signed in to change notification settings

el3um4s/renderer-for-electron-system-info

Repository files navigation

RENDERER for Electron: System Info

Allow the renderer to get information about the version of Electron, Chrome and NodeJS

NPM link: @el3um4s/renderer-for-electron-system-info

Use @el3um4s/ipc-for-electron and @el3um4s/ipc-for-electron-system-info to allow communication between Electron and a web page

Install and use the package

To use the package in a project:

npm i @el3um4s/renderer-for-electron-system-info

Or with Electron:

npm i @el3um4s/renderer-for-electron-system-info @el3um4s/ipc-for-electron-system-info @el3um4s/ipc-for-electron

Then the preload.ts file:

import { generateContextBridge } from "@el3um4s/ipc-for-electron";
import systemInfo from "@el3um4s/ipc-for-electron-system-info";

const listAPI = [systemInfo];

generateContextBridge(listAPI);

In the renderer file:

import systemInfo from "@el3um4s/renderer-for-electron-system-info";
let isWindows = false;

systemInfo.requestIsWindows({
  callback: (data) => {
    isWindows = data.isWindows;
  },
});

let app: string = "-";
let chrome: string = "-";
let node: string = "-";
let electron: string = "-";

systemInfo.requestSystemInfo({
  callback: (data) => {
    chrome = data.chrome;
    node = data.node;
    electron = data.electron;
    app = data.app;
  },
});

In the renderer you can use:

let isWindows = false;

globalThis.api.systemInfo.send("requestIsWindows", null);
globalThis.api.systemInfo.receive("getIsWindows", (data) => {
  isWindows = data.isWindows;
});

let chrome: string = "-";
let node: string = "-";
let electron: string = "-";
let app: string = "-";

globalThis.api.systemInfo.send("requestSystemInfo", null);
globalThis.api.systemInfo.receive("getSystemInfo", (data) => {
  chrome = data.chrome;
  node = data.node;
  electron = data.electron;
  app = data.app;
});

API: Electron Side

  • requestSystemInfo - Request the version of Electron, Chrome and NodeJS. The response is sent to the getSystemInfo channel
  • requestIsWindows - Request if the OS is Windows. The response is sent to the getIsWindows channel

API: Renderer Side - Request

requestSystemInfo = async (options: { callback?: (arg0: SystemInfo) => void; apiKey?: string; }): Promise<SystemInfo>

example:

import systemInfo from "@el3um4s/renderer-for-electron-system-info";

let app: string = "-";
let chrome: string = "-";
let node: string = "-";
let electron: string = "-";

systemInfo.requestSystemInfo({
  apiKey: "ipc",
  callback: (data) => {
    console.log("DATA OK", data);
    chrome = data.chrome;
    node = data.node;
    electron = data.electron;
    app = data.app;
  },
});

requestIsWindows = async (options: { callback?: (arg0: IsWindows) => void; apiKey?: string; }): Promise<IsWindows>

example:

import systemInfo from "@el3um4s/renderer-for-electron-system-info";

let isWindows = false;

systemInfo.requestIsWindows({
  apiKey: "ipc",
  callback: (data) => {
    console.log("DATA OK", data);
    isWindows = data.isWindows;
  },
});

API: Renderer Side - Response

on.getSystemInfo = async (options: { callback?: (arg0: SystemInfo) => void; apiKey?: string; }): Promise<SystemInfo>

example:

import systemInfo from "@el3um4s/renderer-for-electron-system-info";

let app: string = "-";
let chrome: string = "-";
let node: string = "-";
let electron: string = "-";
systemInfo.requestSystemInfo();

systemInfo.on.getSystemInfo({
  apiKey: "ipc",
  callback: (data) => {
    console.log("DATA OK", data);
    chrome = data.chrome;
    node = data.node;
    electron = data.electron;
    app = data.app;
  },
});

on.getIsWindows = async (options: { callback?: (arg0: IsWindows) => void; apiKey?: string; }): Promise<IsWindows>

example:

import systemInfo from "@el3um4s/renderer-for-electron-system-info";

let isWindows = false;

systemInfo.requestIsWindows();

systemInfo.on.getIsWindows({
  apiKey: "ipc",
  callback: (data) => {
    console.log("DATA OK", data);
    isWindows = data.isWindows;
  },
});

Types

SystemInfo

interface SystemInfo {
  chrome: string;
  node: string;
  electron: string;
  app: string;
}

IsWindows

interface IsWindows {
  isWindows: boolean;
}

DefaultApiKey

type DefaultApiKey = "ipc";