Перейти к основному содержанию

Representing Files in a BrowserWindow


On macOS, you can set a represented file for any window in your application. The represented file's icon will be shown in the title bar, and when users Command-Click or Control-Click, a popup with a path to the file will be shown.

Представленный файл

NOTE: The screenshot above is an example where this feature is used to indicate the currently opened file in the Atom text editor.

You can also set the edited state for a window so that the file icon can indicate whether the document in this window has been modified.

Для установления представленного файла можно использовать BrowserWindow.setRepresentedFilename и BrowserWindow.setDocumentEdited APIs.


const { app, BrowserWindow } = require('electron/main')
const os = require('node:os')

function createWindow () {
const win = new BrowserWindow({
width: 800,
height: 600



app.whenReady().then(() => {

app.on('activate', () => {
if (BrowserWindow.getAllWindows().length === 0) {

app.on('window-all-closed', () => {
if (process.platform !== 'darwin') {

After launching the Electron application, click on the title with Command or Control key pressed. You should see a popup with the represented file at the top. In this guide, this is the current user's home directory:

Represented file