Skip to content
On this page

useIpcRenderer

Category
Package
@vueuse/electron
Last Changed
3 months ago

Provides ipcRenderer and it's all APIs. available in add-on @vueuse/electron

Usage

import { useIpcRenderer } from '@vueuse/electron'

// enable nodeIntegration if you don't provide ipcRenderer explicitly 
// @see: https://www.electronjs.org/docs/api/webview-tag#nodeintegration
const ipcRenderer = useIpcRenderer()

// Ref result will return
const result = ipcRenderer.invoke<string>('custom-channel', 'some data')
const msg = computed(() => result.value?.msg)

// remove listener automatically on unmounted
ipcRenderer.on('custom-event', (event, ...args) => {
    console.log(args)
})

import { useIpcRenderer } from '@vueuse/electron'

// enable nodeIntegration if you don't provide ipcRenderer explicitly 
// @see: https://www.electronjs.org/docs/api/webview-tag#nodeintegration
const ipcRenderer = useIpcRenderer()

// Ref result will return
const result = ipcRenderer.invoke<string>('custom-channel', 'some data')
const msg = computed(() => result.value?.msg)

// remove listener automatically on unmounted
ipcRenderer.on('custom-event', (event, ...args) => {
    console.log(args)
})

Type Declarations

Show Type Declarations
/**
 * Result from useIpcRenderer
 *
 * @see https://www.electronjs.org/docs/api/ipc-renderer
 * @export
 * @interface UseIpcRendererReturn
 */
export interface UseIpcRendererReturn {
  /**
   * Listens to channel, when a new message arrives listener would be called with listener(event, args...).
   * [ipcRenderer.removeListener](https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererremovelistenerchannel-listener) automatically on unmounted.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendereronchannel-listener
   * @param {string} channel
   * @param {IpcRendererListener} listener
   * @returns {IpcRenderer}
   */
  on(channel: string, listener: IpcRendererListener): IpcRenderer
  /**
   * Adds a one time listener function for the event. This listener is invoked only the next time a message is sent to channel, after which it is removed.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendereroncechannel-listener
   * @param {string} channel
   * @param {(event: IpcRendererEvent, ...args: any[]) => void} listener
   * @returns {IpcRenderer}
   */
  once(
    channel: string,
    listener: (event: IpcRendererEvent, ...args: any[]) => void
  ): IpcRenderer
  /**
   * Removes the specified listener from the listener array for the specified channel.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererremovelistenerchannel-listener
   * @param {string} channel
   * @param {(...args: any[]) => void} listener
   * @returns {IpcRenderer}
   */
  removeListener(
    channel: string,
    listener: (...args: any[]) => void
  ): IpcRenderer
  /**
   * Removes all listeners, or those of the specified channel.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererremovealllistenerschannel
   * @param {string} channel
   * @returns {IpcRenderer}
   */
  removeAllListeners(channel: string): IpcRenderer
  /**
   * Send an asynchronous message to the main process via channel, along with arguments.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendchannel-args
   * @param {string} channel
   * @param {...any[]} args
   */
  send(channel: string, ...args: any[]): void
  /**
   * Returns Promise<any> - Resolves with the response from the main process.
   * Send a message to the main process via channel and expect a result ~~asynchronously~~.
   * As composition-api, it makes asynchronous operations look like synchronous.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererinvokechannel-args
   * @template T
   * @param {string} channel
   * @param {...any[]} args
   * @returns {(Ref<T | null>)}
   */
  invoke<T>(channel: string, ...args: any[]): Ref<T | null>
  /**
   * Returns any - The value sent back by the ipcMain handler.
   * Send a message to the main process via channel and expect a result synchronously.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendsyncchannel-args
   * @template T
   * @param {string} channel
   * @param {...any[]} args
   * @returns {(Ref<T | null>)}
   */
  sendSync<T>(channel: string, ...args: any[]): Ref<T | null>
  /**
   * Send a message to the main process, optionally transferring ownership of zero or more MessagePort objects.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererpostmessagechannel-message-transfer
   * @param {string} channel
   * @param {*} message
   * @param {MessagePort[]} [transfer]
   */
  postMessage(channel: string, message: any, transfer?: MessagePort[]): void
  /**
   * Sends a message to a window with webContentsId via channel.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendtowebcontentsid-channel-args
   * @param {number} webContentsId
   * @param {string} channel
   * @param {...any[]} args
   */
  sendTo(webContentsId: number, channel: string, ...args: any[]): void
  /**
   * Like ipcRenderer.send but the event will be sent to the <webview> element in the host page instead of the main process.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendtohostchannel-args
   * @param {string} channel
   * @param {...any[]} args
   */
  sendToHost(channel: string, ...args: any[]): void
}
/**
 * Get the `ipcRenderer` module with all APIs.
 *
 * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendtohostchannel-args
 * @export
 * @param {IpcRenderer} [ipcRenderer]
 * @returns {UseIpcRendererReturn}
 */
export declare function useIpcRenderer(
  ipcRenderer?: IpcRenderer
): UseIpcRendererReturn
/**
 * Result from useIpcRenderer
 *
 * @see https://www.electronjs.org/docs/api/ipc-renderer
 * @export
 * @interface UseIpcRendererReturn
 */
export interface UseIpcRendererReturn {
  /**
   * Listens to channel, when a new message arrives listener would be called with listener(event, args...).
   * [ipcRenderer.removeListener](https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererremovelistenerchannel-listener) automatically on unmounted.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendereronchannel-listener
   * @param {string} channel
   * @param {IpcRendererListener} listener
   * @returns {IpcRenderer}
   */
  on(channel: string, listener: IpcRendererListener): IpcRenderer
  /**
   * Adds a one time listener function for the event. This listener is invoked only the next time a message is sent to channel, after which it is removed.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendereroncechannel-listener
   * @param {string} channel
   * @param {(event: IpcRendererEvent, ...args: any[]) => void} listener
   * @returns {IpcRenderer}
   */
  once(
    channel: string,
    listener: (event: IpcRendererEvent, ...args: any[]) => void
  ): IpcRenderer
  /**
   * Removes the specified listener from the listener array for the specified channel.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererremovelistenerchannel-listener
   * @param {string} channel
   * @param {(...args: any[]) => void} listener
   * @returns {IpcRenderer}
   */
  removeListener(
    channel: string,
    listener: (...args: any[]) => void
  ): IpcRenderer
  /**
   * Removes all listeners, or those of the specified channel.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererremovealllistenerschannel
   * @param {string} channel
   * @returns {IpcRenderer}
   */
  removeAllListeners(channel: string): IpcRenderer
  /**
   * Send an asynchronous message to the main process via channel, along with arguments.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendchannel-args
   * @param {string} channel
   * @param {...any[]} args
   */
  send(channel: string, ...args: any[]): void
  /**
   * Returns Promise<any> - Resolves with the response from the main process.
   * Send a message to the main process via channel and expect a result ~~asynchronously~~.
   * As composition-api, it makes asynchronous operations look like synchronous.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererinvokechannel-args
   * @template T
   * @param {string} channel
   * @param {...any[]} args
   * @returns {(Ref<T | null>)}
   */
  invoke<T>(channel: string, ...args: any[]): Ref<T | null>
  /**
   * Returns any - The value sent back by the ipcMain handler.
   * Send a message to the main process via channel and expect a result synchronously.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendsyncchannel-args
   * @template T
   * @param {string} channel
   * @param {...any[]} args
   * @returns {(Ref<T | null>)}
   */
  sendSync<T>(channel: string, ...args: any[]): Ref<T | null>
  /**
   * Send a message to the main process, optionally transferring ownership of zero or more MessagePort objects.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrendererpostmessagechannel-message-transfer
   * @param {string} channel
   * @param {*} message
   * @param {MessagePort[]} [transfer]
   */
  postMessage(channel: string, message: any, transfer?: MessagePort[]): void
  /**
   * Sends a message to a window with webContentsId via channel.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendtowebcontentsid-channel-args
   * @param {number} webContentsId
   * @param {string} channel
   * @param {...any[]} args
   */
  sendTo(webContentsId: number, channel: string, ...args: any[]): void
  /**
   * Like ipcRenderer.send but the event will be sent to the <webview> element in the host page instead of the main process.
   *
   * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendtohostchannel-args
   * @param {string} channel
   * @param {...any[]} args
   */
  sendToHost(channel: string, ...args: any[]): void
}
/**
 * Get the `ipcRenderer` module with all APIs.
 *
 * @see https://www.electronjs.org/docs/api/ipc-renderer#ipcrenderersendtohostchannel-args
 * @export
 * @param {IpcRenderer} [ipcRenderer]
 * @returns {UseIpcRendererReturn}
 */
export declare function useIpcRenderer(
  ipcRenderer?: IpcRenderer
): UseIpcRendererReturn

Source

SourceDocs

Contributors

Anthony Fu
ArcherGu

Changelog

v5.0.0-beta.8 on 6/4/2021
423a6 - feat: new add-one & new functions (#547)
useIpcRenderer has loaded