Объект webContents

После создания окна для доступа к Web-странице можно воспользоваться свойством webContents. Например, для отображения панели Инструменты разработчика нужно вызвать метод openDevTools():

win.webContents.openDevTools();

А для отправки события используется метод send() (см. Процессы Main и Renderer):

win.webContents.send('win-event-send-data', data);

Работа с URL

Загрузить Web-страницу в окно позволяют следующие методы:

• loadFile(<Путь>[, <Объект с опциями>]) — загружает локальный файл. Возвращает объект Promise, который успешно разрешается при удачной загрузке. Пример:

win.webContents.loadFile('index.htm').then(() => {
   console.log('loadFile OK');
}).catch((e) => {
   console.log(e);
});

• loadURL(<URL>[, <Объект с опциями>]) — загружает HTML-документ по указанному URL. Во втором параметре указывается объект с опциями userAgent, httpReferrer, extraHeaders, postData и baseURLForDataURL. Возвращает объект Promise, который успешно разрешается при удачной загрузке. Пример загрузки локального файла:

let url = require('url').format({
   protocol: 'file',
   slashes: true,
   pathname: require('path').join(__dirname, 'index.html')
});
win.webContents.loadURL(url).then(() => {
   console.log('loadURL OK');
}).catch((e) => {
   console.log(e);
});

Обработать успешное окончание загрузки Web-страницы позволяет также событие did-finish-load:

win.webContents.on('did-finish-load', () => {
   console.log('did-finish-load');
});

Получить загруженный URL позволяет метод getURL():

console.log( 'getURL():', win.webContents.getURL() );
// getURL(): file:///C:/book/e1/index.html

С помощью методов setUserAgent(<Значение>) и getUserAgent() можно изменить или получить строку идентификации Web-браузера:

console.log( 'getUserAgent():', win.webContents.getUserAgent() );
// getUserAgent(): Mozilla/5.0 (Windows NT 6.2; Win64; x64)
// AppleWebKit/537.36 (KHTML, like Gecko) e1/1.0.0 Chrome/89.0.4389.128
// Electron/12.0.5 Safari/537.36

Заголовок Web-страницы

Получить заголовок загруженной Web-страницы позволяет метод getTitle():

console.log( 'getTitle():', win.webContents.getTitle() );

Перезагрузка Web-страницы

Выполнить перезагрузку Web-страницы позволяют методы reload() и reloadIgnoringCache():

win.webContents.reload();

Масштаб Web-страницы

Управлять масштабом Web-страницы позволяют следующие методы:

• setZoomFactor(<Значение>) — позволяет указать коэффициент масштабирования страницы. Значение 2.0 означает 200%. Пример указания 300%:

win.webContents.setZoomFactor(3.0);

• getZoomFactor() — возвращает коэффициент масштабирования;
• setZoomLevel(<Уровень>) — изменяет уровень масштаба. Оригинальный размер соответствует уровню 0;
• getZoomLevel() — возвращает текущий уровень масштаба.

Работа с буфером обмена

Выполнять операции с буфером обмена позволяют следующие методы:

• cut() — команда Вырезать;
• copy() — команда Копировать;
• paste() — команда Вставить.

Работа с выделением

Выполнять операции с выделением позволяют следующие методы:

• delete() — команда Удалить;
• selectAll() — команда Выделить все;
• unselect() — снимает выделение.

Команды Отменить и Повторить

Метод undo() выполняет команду Отменить, а метод redo() — команду Повторить.