Repository files navigation

txikia (basque): small, tiny.

txiki.js is a small and powerful JavaScript runtime. It targets state-of-the-art ECMAScriptand aims to beWinterCG compliant.

It's built on the shoulders of giants: it usesQuickJS-ng as its JavaScript engine andlibuv as the platform layer.

See it in action here:

First head over tobuilding and build the runtime.

$ ./build/tjseval"console.log('hello world')"hello world$

If you want to run a script you can usetjs run:

$ ./build/tjs run examples/hello_world.jshello world$

Explore all the options:

$ ./build/tjs --help

For TS support see@txikijs/types.

Support for theES2023 specification (almost complete).

txiki.js aims to beWinterCG compliant, you can track the progresshere.

• alert, confirm, prompt (1)
• Console
• Crypto (2)
• Encoding API
• EventTarget
• fetch
• JSON modules
• Performance
• setTimeout, setInterval
• Storage API
• Streams API
• URL
• URLPattern
• URLSearchParams
• WebAssembly (3)
• WebSocket
• Web Workers API

(1): All of them are async.

(2): No subtle support.

(3): No tables, globals or memory support.

• TCP and UDP sockets
• Unix sockets / named pipes
• Signal handling
• File operations
• Child processes
• DNS (getaddrinfo)
• WASI
• Miscellaneous utility functions

See thefull API documentation.

Other extras:

• Import directly from HTTP(S) URLs
• Import JSON files
• Builtin test runner

The following modules compose the standard library:

• tjs:assert
• tjs:ffi
• tjs:getopts
• tjs:hashing
• tjs:ipaddr
• tjs:path
• tjs:sqlite
• tjs:uuid

• GNU/Linux
• macOS
• Windows (beta)
• Other Unixes (please test!)

CMake is necessary.

NOTE: The txiki.js build depends on a number of git submodules (libffi,libuv andwasm3).If you didn't already clone this repository recursively, make sure you initialize thesesubmodules withgit submodule update --init before proceeding to the build.

Install dependencies (libcurl,build-essential,cmake,makeinfo,autoreconf,libtool):

# On Debian / Ubuntusudo apt install libcurl4-openssl-dev build-essential cmake autoconf texinfo libtool

Install dependencies (cmake,autoconf):

brew install cmake autoconf automake libtool texinfo

# Get the codegit clone --recursive https://github.com/saghul/txiki.js --shallow-submodules&&cd txiki.js# Compile it!make# Run the REPL./build/tjs

pacman -S git make pactoyspacboy -S curl-winssl:p toolchain:p cmake:p ninja:p

make

maketest

At this time txiki.js usescalendar versioning with the form YY.MM.MICRO.

Built with ❤️ by saghul and these awesomecontributors.