ubuntu-22.04.3-desktop-amd64/casper/filesystem/usr/share/doc/gjs
Dwayne Hart 148999cf35 Adding the filesystem content from the Ubuntu 22.04 LTS amd64 squashfs. 2023-11-12 20:31:01 -03:30
..
examples Adding the filesystem content from the Ubuntu 22.04 LTS amd64 squashfs. 2023-11-12 20:31:01 -03:30
NEWS.gz Adding the filesystem content from the Ubuntu 22.04 LTS amd64 squashfs. 2023-11-12 20:31:01 -03:30
README.md Adding the filesystem content from the Ubuntu 22.04 LTS amd64 squashfs. 2023-11-12 20:31:01 -03:30
changelog.Debian.gz Adding the filesystem content from the Ubuntu 22.04 LTS amd64 squashfs. 2023-11-12 20:31:01 -03:30
copyright Adding the filesystem content from the Ubuntu 22.04 LTS amd64 squashfs. 2023-11-12 20:31:01 -03:30

README.md

Build Status Coverage report Contributors Last commit Search hit License License

JavaScript bindings for GNOME

Use the GNOME platform libraries in your JavaScript programs. GJS powers GNOME Shell, Polari, GNOME Documents, and many other apps. Under the hood it uses SpiderMonkey, Mozilla's JavaScript engine originally developed for Firefox.

Installation

Available as part of your GNOME distribution by default. In most package managers the package will be called gjs.

Usage

GJS includes a command-line interpreter, usually installed in /usr/bin/gjs. Type gjs to start it and test out your JavaScript statements interactively. Hit Ctrl+D to exit.

gjs filename.js runs a whole program. gjs -d filename.js does that and starts a debugger as well.

There are also facilities for generating code coverage reports. Type gjs --help for more information.

-d only available in gjs >= 1.53.90

Contributing

For instructions on how to get started contributing to GJS, please read the contributing guide, https://gitlab.gnome.org/GNOME/gjs/blob/HEAD/CONTRIBUTING.md.

History

GJS probably started in August 2008 with this blog post and this experimental code. GJS in its current form was first developed in October 2008 at a company called litl, for their litl webbook product. It was soon adopted as the basis of GNOME Shell's UI code and extensions system and debuted as a fundamental component of GNOME 3.0.

In February 2013 at the GNOME Developer Experience Hackfest GJS was declared the 'first among equals' of languages for GNOME application development. That proved controversial for many, and was later abandoned.

At the time of writing (2018) GJS is used in many systems including Endless OS's framework for offline content and, as a forked version, Cinnamon.

Reading material

Documentation

JavaScript & SpiderMonkey

GNOME Contribution

License

Dual licensed under LGPL 2.0+ and MIT.

Thanks

The form of this README was inspired by Nadia Odunayo on the Greater Than Code podcast.