Skip to content
Interactive JavaScript and TypeScript programming with Jupyter
TypeScript Python JavaScript
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
bin Enrich tslab CLI Oct 25, 2019
docs
python Register globally-installed tslab to Jupyter. Nov 9, 2019
src Handle comm_info_request to suppress a warning on startup. Nov 26, 2019
.gitignore Upgrade zeromq to 6.x to support Node.js v13. Nov 8, 2019
.travis.yml Upgrade zeromq to 6.x to support Node.js v13. Nov 8, 2019
LICENSE Change the license to Apache2.0. Nov 13, 2019
NOTICE Change the license to Apache2.0. Nov 13, 2019
README.md Minor updates. Nov 22, 2019
jest.config.js Updated. Jul 29, 2019
package.json Merge remote-tracking branch 'refs/remotes/origin/master' Dec 4, 2019
tsconfig.json Use esModuleInterop to comple tslab src. Nov 2, 2019

README.md

tslab

Build Status Binder npm version

tslab is an interactive programming environment and REPL with Jupyter for JavaScript and TypeScript users. You can write and execute JavaScript and TypeScript interactively on browsers and save results as Jupyter notebooks.

Features

  • Interactive JavaScript and TypeScript programming with Jupyter and Node.js.
  • The power of types from TypeScript project.
    • Type safety even in JavaScript mode.
    • Rich code completion and code inspection thanks to types.
  • Display non-text contents like images, HTML, JavaScript, SVG, etc...
  • Interactive deep neural network machine learning (TensorFlow.js) and data exploration with JavaScript.
  • JavaScript is 40x faster than Python.
  • TypeScript 3.7 support.
  • Top-level await support.
  • REPL console support.

Screenshots: Code inspection (Shift-Tab) and completion (Tab)

Try tslab without installing it

Binder

Thanks to binder (mybinder.org), you can try tslab on your browsers without installing it into your system. Open a temporary Jupyter Notebook from the button above and enjoy interactive JavaScript and TypeScript programming.

Example notebooks

To learn what what we can do with JavaScript on Jupyter, view example notebooks in nbviewer.

If nbviewer is down, please view the notebooks on GitHub instead.

Installing tslab

Prerequisites

Installing tslab by npm

npm install -g tslab

Please make sure tslab command is available in your terminal.

tslab install --version

Registering tslab to Jupyter

tslab install [--python=python3]

By default, tslab is registered with python3 in unix-like system and python in Windows. If Jupyter is installed with a different Python in your system, please specify the python command with --python flag.

After you run tslab install, please check two kernels (jslab and tslab) are installed properly to jupyter.

$ jupyter kernelspec list
Available kernels:
  jslab      /usr/local/google/home/yunabe/.local/share/jupyter/kernels/jslab
  tslab      /usr/local/google/home/yunabe/.local/share/jupyter/kernels/tslab

Usage: JupyterLab and Jupyter Notebook

After you register tslab to Jupyter, start JupyterLab and Jupyter Notebook as usual. You can now create JavaScript and TypeScript notebooks.

# JupyterLab
# `--port=` to change the port to accept connections.
# `--ip=0.0.0.0` to accept external connections.
jupyter lab [--port=8888] [--ip=0.0.0.0]

# Jupyter Notebook
jupyter notebook

In Jupyter, you can complete code by pressing Tab and show tooltips by pressing Shift + Tab.

Usage: REPL console

You can also use tslab and Jupyter as an interactive console (REPL). To use tslab as REPL, please run jupyter console with --kernel=jslab (JavaScript) or --kernel=tslab (TypeScript).

jupyter console --kernel=tslab

Clarification

tslab is an interactive JavaScript and TypeScript programming environment on Node.js (aka Server-side JavaScript). tslab does not support code execution on browsers (aka Client-side JavaScript) at this moment.

Read more

You can’t perform that action at this time.