Saltar al contenido principal

shell

Administra los archivos y los URLs utilizando las aplicaciones por defecto.

Process: Main, Renderer (non-sandboxed only)

El módulo shell proporciona las funciones relacionadas con la integración de escritorio.

Ejemplo de cómo abrir un URL en el navegador por defecto del usuario:

const { shell } = require('electron')

shell.openExternal('https://github.com')

Note: While the shell module can be used in the renderer process, it will not function in a sandboxed renderer.

Métodos

El módulo shell tiene los siguientes métodos:

shell.showItemInFolder(fullPath)

  • fullPath cadena

Muestra el archivo dado en un gestor de archivos. Si es posible, seleccione el archivo.

shell.openPath(path)

  • path string

Devuelve Promise<string> - Resuelve con una cadena conteniendo el mensaje de error correspondiente al fallo si un error ha ocurrido, de lo contrario "".

Abre el archivo determinado en el escritorio por defecto.

shell.openExternal(url[, options])

  • url string - Máximo 2081 caracteres en windows.
  • options Object (opcional)
    • activate boolean (opcional) macOs - true para llevar la aplicación abierta al primer plano. El valor por defecto es true.
    • workingDirectory string (opcional) Windows - El directorio de trabajo.
    • logUsage boolean (optional) Windows - Indicates a user initiated launch that enables tracking of frequently used programs and other behaviors. Por defecto es false.

Devuelve Promise<void>

Abre el protocolo URL externo dado de manera predeterminada en el escritorio. (Por ejemplo, mailto: URLs en el agente de correo predeterminado del usuario).

shell.trashItem(path)

  • path string - path to the item to be moved to the trash.

Devuelve Promise<void> - Resuelve cuando la operación ha sido completada. Rejects if there was an error while deleting the requested item.

This moves a path to the OS-specific trash location (Trash on macOS, Recycle Bin on Windows, and a desktop-environment-specific location on Linux).

shell.beep()

Reproduce el sonido bip.

shell.writeShortcutLink(shortcutPath[, operation], options) Windows

  • shortcutPath string
  • operation string (opcional) - El valor por defecto es create; puede ser uno de los siguientes:
    • create - Crea un nuevo acceso directo, sobrescribiendo si es necesario.
    • update - Actualiza las propiedades especificadas solo en un acceso directo existente.
    • replace - Sobrescribe un acceso directo existente. Y falla si el acceso directo no existe.
  • options ShortcutDetails

Devuelve boolean - Si el acceso directo fue creado con éxito.

Crea o actualiza un enlace de acceso directo a shortcutPath.

shell.readShortcutLink(shortcutPath) Windows

  • shortcutPath string

Devuelve ShortcutDetails

Resuelve el enlace de acceso directo a shortcutPath.

Aparecerá una excepción cuando ocurre cualquier error.