Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/morganstanley/desktopjs
desktopJS provides a common API across multiple HTML5 containers. By programming to a common API, applications can target multiple HTML5 containers without change.
https://github.com/morganstanley/desktopjs
desktop-app electron frontend
Last synced: 11 days ago
JSON representation
desktopJS provides a common API across multiple HTML5 containers. By programming to a common API, applications can target multiple HTML5 containers without change.
- Host: GitHub
- URL: https://github.com/morganstanley/desktopjs
- Owner: morganstanley
- License: apache-2.0
- Created: 2017-05-15T12:10:44.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-10-01T10:44:22.000Z (about 1 month ago)
- Last Synced: 2024-10-31T08:39:34.918Z (13 days ago)
- Topics: desktop-app, electron, frontend
- Language: TypeScript
- Homepage: http://opensource.morganstanley.com/desktopJS
- Size: 3.23 MB
- Stars: 76
- Watchers: 15
- Forks: 40
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
==========
[](https://www.npmjs.com/package/@morgan-stanley/desktopjs)
[](https://github.com/MorganStanley/desktopJS/actions/workflows/continuous-integration.yml)
[](https://securityscorecards.dev/viewer/?uri=github.com/morganstanley/desktopJS)
[](https://codecov.io/gh/MorganStanley/desktopJS)
desktopJS is a common API across multiple HTML5 containers. By programming to a
common API, applications can target multiple HTML5 containers without change. Detecting
what container in which you are hosted, desktopJS provides shims and polyfills to
bridge the common API to the underlying container. The goal is to help applications be
container agnostic and provide portability when multiple container deployments are desired.
Usage
---------------
The first step is to simply [resolve](http://opensource.morganstanley.com/desktopJS/modules/_desktopjs_src_registry_.html#resolvecontainer) the current [container](http://opensource.morganstanley.com/desktopJS/classes/_desktopjs_src_container_.container.html). This enumerates
all registered containers (including your own custom container or derived custom implementations) and
returns the container implementation that matches.
```
var container = desktopJS.resolveContainer();
console.log("Container: " + container.hostType);
```
Interact with the [container](http://opensource.morganstanley.com/desktopJS/classes/_desktopjs_src_container_.container.html) via a single api instead of having conditional code or applications
based on deployment.
```
container.addTrayIcon({ icon: 'assets/img/application.png', text: 'Example' }, () => {
console.log("Icon clicked");
});
```
Building
-------
The library uses gulp and rollup for building. All build dependencies are included as
devDependencies and are installed during npm install.
```
$ npm install
```
Build the project. This runs static analysis, unit tests and bundles the output with
rollup.
```
$ npm run build && npm test
```
For those using [Visual Studio Code](https://code.visualstudio.com/), tasks.json has a build task.
Development
-----------
### Local Hosting
To run the examples or to manually test scenarios in each container, there is a gulp task providing
a local server with live reload. This can be run directly via gulp or through npm.
```
$ npm start
```
This is configured to listen at [http://localhost:8000](http://localhost:8000) and will reload upon
any change to the project build output under /dist or the web example under /examples/web. All of the
included examples make use of this example application to showcase the portability of one
codebase.
### Unit tests
The tests can be run independent of the build.
```
$ npm test
```
A task is provided for [Visual Studio Code](https://code.visualstudio.com/) users that can be launched
from the command palette via
```
>Tasks: Run Test Task
```
or it is recommended to define a custom keyboard binding.
```
{
"key": "ctrl+shift+t",
"command": "workbench.action.tasks.test"
}
```
Examples
--------
Examples showcasing usage of desktopJS for various containers and scenarios can be found under
the [examples](https://github.com/MorganStanley/desktopJS/tree/main/examples) directory.
Feature Matrix
--------
Feature Browser ComposeUI
Hosting
Web
:heavy_check_mark:
:heavy_check_mark:
WPF
:x:
:x:
WinForms
:x:
:x:
Java
:x:
:x:
Win32
:x:
:x:
Flash
:heavy_check_mark:
:x:
MessageBus
Cross Window
:heavy_check_mark:
:heavy_check_mark:
Cross Technology
:x:
:heavy_check_mark:
Cross Process
:x:
:heavy_check_mark:
Cross Machine
:x:
:x:
Platform
Windows
:heavy_check_mark:
:heavy_check_mark:
Mac
:heavy_check_mark:
:x:
Linux
:heavy_check_mark:
:x:
Node.js
Bootstrap
:x:
:x:
Renderer
:x:
:x:
Notifications
Native API
:heavy_check_mark:
:x:
Web Notifications
:heavy_check_mark:
:x:
System tray
Icon
:x:
:heavy_check_mark:
Context Menu
:x:
:x:
Windows
Popups
:heavy_check_mark:
:x:
Modal
:x:
:x:
Frameless
:x:
:x:
Screenshot
:heavy_check_mark:
:x:
Window Management
Persistence
desktopJS
:x:
Grouping
:x:
:x:
Snap/Dock
:x:
:x:
Tabbing
:heavy_check_mark:
:x:
Remote Administration
:x:
:x:
Restart
:x:
:x:
Shutdown
:x:
:x:
Screenshot
:x:
:x: