{"Package":"QuickJSR","Title":"Interface for the 'QuickJS' Lightweight 'JavaScript' Engine","Version":"1.6.0","Authors@R":"c(\nperson(c(\"Andrew\", \"R.\"), \"Johnson\", , \"andrew.johnson@arjohnsonau.com\", role = c(\"aut\", \"cre\"),\ncomment = c(ORCID = \"0000-0001-7000-8065\")),\nperson(\"QuickJS\", \"Authors\", role = c(\"cph\"),\ncomment = \"QuickJS sources and headers\"),\nperson(\"QuickJS-NG\", \"Authors\", role = c(\"cph\"),\ncomment = \"QuickJS-NG sources and headers\")\n)","Description":"An 'R' interface to the 'QuickJS' portable 'JavaScript'\nengine. The engine and all 'R' to 'JavaScript' interoperability is bundled\nwithin the package, requiring no dependencies beyond a 'C' compiler.","License":"MIT + file LICENSE","URL":"https://github.com/andrjohns/QuickJSR,\nhttps://bellard.org/quickjs/","BugReports":"https://github.com/andrjohns/QuickJSR/issues","Suggests":"knitr, rmarkdown, tinytest","Encoding":"UTF-8","Language":"en-AU","NeedsCompilation":"yes","RoxygenNote":"7.3.1","SystemRequirements":"GNU make","VignetteBuilder":"knitr","Packaged":"2025-02-26 15:48:10 UTC; Andrew","Author":"Andrew R. Johnson [aut, cre] (),\nQuickJS Authors [cph] (QuickJS sources and headers),\nQuickJS-NG Authors [cph] (QuickJS-NG sources and headers)","Maintainer":"Andrew R. Johnson ","Repository":"CRAN","Date/Publication":"2025-02-26 18:00:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/QuickJSR_1.6.0.tar.gz","jsonAuthors":[{"name":["Andrew Johnson","R. Johnson"],"email":"andrew.johnson@arjohnsonau.com","maintainer":true},{"name":"QuickJS Authors","email":null,"maintainer":false},{"name":"QuickJS-NG Authors","email":null,"maintainer":false}],"readme":"\n\n\n# QuickJSR\n\n\n\n[![R-CMD-check](https://github.com/andrjohns/QuickJSR/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/andrjohns/QuickJSR/actions/workflows/R-CMD-check.yaml)\n[![CRAN\nstatus](https://www.r-pkg.org/badges/version/QuickJSR)](https://CRAN.R-project.org/package=QuickJSR)\n[![Downloads](https://cranlogs.r-pkg.org/badges/QuickJSR?color=blue)](https://CRAN.R-project.org/package=QuickJSR)\n[![QuickJSR status\nbadge](https://andrjohns.r-universe.dev/badges/QuickJSR)](https://andrjohns.r-universe.dev/QuickJSR)\n\n\nA portable, lightweight, zero-dependency JavaScript engine for R, using\n[QuickJS](https://bellard.org/quickjs/).\n\nValues and objects are directly passed between R and QuickJS, with no\nneed for serialization or deserialization. This both reduces overhead\nand allows for more complex data structures to be passed between R and\nJavaScript - including functions.\n\n## Installation\n\nYou can install the development version of QuickJSR from\n[GitHub](https://github.com/) with:\n\n``` r\n# install.packages(\"remotes\")\nremotes::install_github(\"andrjohns/QuickJSR\")\n```\n\nOr you can install pre-built binaries from R-Universe:\n\n``` r\ninstall.packages(\"QuickJSR\", repos = c(\"https://andrjohns.r-universe.dev\",\n \"https://cran.r-project.org\"))\n```\n\n## Usage\n\nFor standalone or simple JavaScript code, you can use the `qjs_eval()`\nfunction:\n\n``` r\nlibrary(QuickJSR)\n\nqjs_eval(\"1 + 1\")\n#> [1] 2\n```\n\n``` r\nqjs_eval(\"Math.random()\")\n#> [1] 0.5193045\n```\n\nFor more complex interactions, you can create a QuickJS context and\nevaluate code within that context:\n\n``` r\nctx <- JSContext$new()\n```\n\nUse the `$source()` method to load JavaScript code into the context:\n\n``` r\n# Code can be provided as a string\nctx$source(code = \"function add(a, b) { return a + b; }\")\n\n# Or read from a file\nsubtract_js <- tempfile(fileext = \".js\")\nwriteLines(\"function subtract(a, b) { return a - b; }\", subtract_js)\nctx$source(file = subtract_js)\n```\n\nThen use the `$call()` method to call a specified function with\narguments:\n\n``` r\nctx$call(\"add\", 1, 2)\n#> [1] 3\n```\n\n``` r\nctx$call(\"subtract\", 5, 3)\n#> [1] 2\n```\n\n### Interacting with R objects, environments, and functions\n\nAs QuickJSR uses the respective C APIs of R and QuickJS to pass values\nbetween the two, this allows for more complex data structures to be\npassed between R and JavaScript.\n\nFor example, you can also pass R functions to be evaluated using\nJavaScript arguments:\n\n``` r\nctx$source(code = \"function callRFunction(f, x, y) { return f(x, y); }\")\nctx$call(\"callRFunction\", function(x, y) x + y, 1, 2)\n#> [1] 3\n```\n\n``` r\nctx$call(\"callRFunction\", function(x, y) paste0(x, \",\", y), \"a\", \"b\")\n#> [1] \"a,b\"\n```\n\nYou can pass R environments to JavaScript, and both access and update\ntheir contents:\n\n``` r\nenv <- new.env()\nenv$x <- 1\nenv$y <- 2\n\nctx$source(code = \"function accessEnv(env) { return env.x + env.y; }\")\nctx$call(\"accessEnv\", env)\n#> [1] 3\n```\n\n``` r\n\nctx$source(code = \"function updateEnv(env) { env.z = env.x * env.y; return env.z;}\")\nctx$call(\"updateEnv\", env)\n#> [1] 2\n```\n\n``` r\n\nenv$z\n#> [1] 2\n```\n\nQuickJSR also provides a global `R` object, which you can use to access\nobjects and functions from various R packages:\n\n``` r\nqjs_eval('R.package(\"base\")[\"Sys.Date\"]()')\n#> [1] \"2024-06-07 03:00:00 EEST\"\n```","jobInfo":{"package":"QuickJSR","version":"1.6.0","parsingStatus":"success","parserVersion":2,"parsedAt":"2025-03-31T16:30:29+0000"}}

Description

Usage

Arguments

Value