jscrewit
TypeScript icon, indicating that this package has built-in type declarations

2.36.0 • Public • Published

JScrewIt · npm version

Use JScrewIt to convert your JavaScript code into JSFuck. JSFuck is an encoding technique that uses only the six characters ! ( ) + [ ] to produce syntactically correct JavaScript that can still run in a browser or another JavaScript engine without any additional software.

Play now with jscrew.it, or give a look at jQuery Screwed for a true example: a working version of jQuery consisting of only six different characters.

JScrewIt was born as a fork of aemkei's JSFuck and has developed into one of the most powerful JSFuck encoders on the web, including a number of unique features.

  • Options to optimize code for a particular set of JavaScript engines or even just for your browser: the more specific your engine choice, the shorter the code you'll get.
  • Support for all modern JavaScript engines (and a few older ones, too).
  • Neatly optimized large file encoding.
  • Encode-as-you-type browser interface.

Example

The following source will do an alert(1) in any browser, including Internet Explorer:

[][(![]+[])[+[]]+([![]]+[][[]])[+!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]]+
(!![]+[])[!![]+!![]+!![]]+(!![]+[])[+!![]]][([+[![]]]+!!++([]+[][(![]+[])[+[]]+(
[![]]+[][[]])[+!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[!![]+!![
]+!![]]+(!![]+[])[+!![]]])[+[]]+[][(![]+[])[+[]]+([![]]+[][[]])[+!![]+[+[]]]+(![
]+[])[!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[!![]+!![]+!![]]+(!![]+[])[+!![]]])[+!!
[]+[+!![]]]+(!!++([]+[][(![]+[])[+[]]+([![]]+[][[]])[+!![]+[+[]]]+(![]+[])[!![]+
!![]]+(!![]+[])[+[]]+(!![]+[])[!![]+!![]+!![]]+(!![]+[])[+!![]]])[+[]]+[][(![]+[
])[+[]]+([![]]+[][[]])[+!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]]+(!![]+[])
[!![]+!![]+!![]]+(!![]+[])[+!![]]])[+!![]+[+!![]]]+([][[]]+[])[+!![]]+(![]+[])[!
![]+!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[+!![]]+([][[]]+[])[+[]]+([+[![]]]+!!++([
]+[][(![]+[])[+[]]+([![]]+[][[]])[+!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]
]+(!![]+[])[!![]+!![]+!![]]+(!![]+[])[+!![]]])[+[]]+[][(![]+[])[+[]]+([![]]+[][[
]])[+!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[!![]+!![]+!![]]+(!
![]+[])[+!![]]])[+!![]+[+!![]]]+(!![]+[])[+[]]+(!!++([]+[][(![]+[])[+[]]+([![]]+
[][[]])[+!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[!![]+!![]+!![]
]+(!![]+[])[+!![]]])[+[]]+[][(![]+[])[+[]]+([![]]+[][[]])[+!![]+[+[]]]+(![]+[])[
!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[!![]+!![]+!![]]+(!![]+[])[+!![]]])[+!![]+[+!
![]]]+(!![]+[])[+!![]]]((!![]+[])[+!![]]+(!![]+[])[!![]+!![]+!![]]+(!![]+[])[+[]
]+([][[]]+[])[+[]]+(!![]+[])[+!![]]+([][[]]+[])[+!![]]+(+[]+[+[]]+[][(![]+[])[+[
]]+([![]]+[][[]])[+!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[!![]
+!![]+!![]]+(!![]+[])[+!![]]])[+!![]+[+!!++([]+[][(![]+[])[+[]]+([![]]+[][[]])[+
!![]+[+[]]]+(![]+[])[!![]+!![]]+(!![]+[])[+[]]+(!![]+[])[!![]+!![]+!![]]+(!![]+[
])[+!![]]])[+[]]]]+(![]+[])[+!![]]+(![]+[])[!![]+!![]]+(!![]+[])[!![]+!![]+!![]]
+(!![]+[])[+!![]]+(!![]+[])[+[]])()(+!![])

Setup Instructions

In the Browser

To use JScrewIt in your project, download jscrewit.js (uncompressed, development version) or jscrewit.min.js (compressed, productive version) from npm and include it in your HTML file.

<script src="jscrewit.js"></script>

Alternatively, just hotlink the latest version on npm using a CDN of your choice.

<script src="https://cdn.jsdelivr.net/npm/jscrewit"></script>

In Node.js

If you are using Node.js, you can install JScrewIt with npm.

npm install jscrewit

Then you can import it in your code in the usual way.

import JScrewIt from "jscrewit"; // ECMAScript module syntax

or

const JScrewIt = require("jscrewit"); // CommonJS syntax

JScrewIt comes with bundled TypeScript declarations: you can use it in TypeScript without installing any additional packages.

Usage

Basics

This will encode the alert(1) example shown above and run it using eval.

const output = JScrewIt.encode("alert(1)");
eval(output);

To encode just a plain string rather than an executable script, enclose the text in double or simple quotes, like when introducing a string literal in JavaScript code.

const output = JScrewIt.encode("'Hello, world!'");
const input = eval(output); // input contains the string "Hello, world!".

We can also use escape sequences to encode newlines and other characters. Note that the initial backslash in an escape sequence must be escaped with another backslash when writing a "sting in a string".

const output = JScrewIt.encode("\"1.\\n2.\\n\\u263A\"");
/*
1.
2.

*/

JScrewIt.encode also accepts an optional second parameter containing options that control various aspects of the encoding. These are covered in detail in the relative section in the API Reference.

Features

One peculiarity of JScrewIt is the ability to generate JSFuck code that is customized for a particular set of JavaScript engines (web browsers or Node.js). This optimized code is shorter than generic JSFuck code but does not work everywhere. To make use of this optimization, we have to specify which features the decoder engine is expected to support.

In order to understand how this works, let's consider the JavaScript functions atob and btoa. Not all browsers support these functions: without any further information, JScrewIt will assume that they are unavailable and will not use them to encode the input. Anyway, if we know in advance that the browsers we plan to target do support atob and btoa indeed, we can let JScrewIt create code that uses those functions whenever that makes the output shorter.

The way to tell JScrewIt to use a particular set of features is by specifying a value for the features option in the second parameter passed to encode.

For instance, a generic alert(1) example for an unspecified environment is 1905 chracters long.

const output = JScrewIt.encode("alert(1)"); // output is 1905 characters

We can save a few characters by indicating that our code is only supposed to run in a browser. We do this using the feature BROWSER.

const options = { features: "BROWSER" };
const output = JScrewIt.encode("alert(1)", options); // 1882 characters

But if we are only interested in code that runs in an up to date Firefox browser, the output length shrinks to about one third:

const options = { features: "FF" };
const output = JScrewIt.encode("alert(1)", options); // 655 characters now

Here we have used another feature: FF. This feature produces the shortest possible code that runs in current Firefox browsers.

We can specify more than one feature using an array, e.g.

const input = "document.body.style.background='red'";
const options = { features: ["ATOB", "WINDOW"] };
const output = JScrewIt.encode(input, options);

As opposed to the previous example, the features specified here refer to certain abilities that may be supported by more than one particular class of browsers or JavaScript engines. Specifically, ATOB indicates native support for the functions atob and btoa, while WINDOW refers to a particular string representation of the global object self, where available. The code generated by JScrewIt will run fine in engines that support both of these features. In engines that don't support both features, the code may not work, and may produce unpredictable results. Most typically, it will throw some kind of error at runtime.

It's important to keep in mind that each of the target engines needs to support every feature we specify. So if we want our JSFuck code to run in Android Browser 4.4, Safari 7.0 and Node.js 13+, we can only specify features supported by all of these engines. These features can be retrieved with JScrewIt.Feature.commonOf.

{ features: JScrewIt.Feature.commonOf("ANDRO_4_4", "NODE_13", "SAFARI_7_0") }

The features turn out to be ESC_HTML_QUOT, GENERIC_ARRAY_TO_STRING, GMT, INCR_CHAR, NAME, NO_IE_SRC and OBJECT_UNDEFINED (a quick way to see this is entering JScrewIt.Feature.commonOf("ANDRO_4_4", "NODE_13", "SAFARI_7_0").toString() in the browser's console). With this knowledge, we could also rewrite the expression above as follows.

{ features: ["ESC_HTML_QUOT", "GMT", "INCR_CHAR", "NAME", "NO_IE_SRC", "OBJECT_UNDEFINED"] }

Finally, note that simply specifying an array of engine features will not achieve the desired effect, as it will result in the union of the features available in every engine rather than in their intersection.

- { features: ["ANDRO_4_4", "NODE_13", "SAFARI_7_0"] }

Further Reading

Compatibility

JScrewIt itself and the code it generates are compatible with the JavaScript engines listed below.

Chrome Chrome 122+
Safari Safari 7.0+
Edge Edge 122+
Firefox Firefox 90+
Opera Opera 108+
Internet Explorer Internet Explorer 9+
Android Browser Android Browser 4.x
Node.js Node.js (all versions)

Engine Support Policy

Only the most recent stable version of Chrome, Edge, Firefox and Opera are guaranteed to be supported at any time, as detailed below.

  • Chrome: (Current - 1) and Current
  • Edge: (Current - 1) and Current
  • Firefox: (Current - 1) and Current, ESR
  • Opera: Current

Expect compatibility with these browsers to change in future releases of JScrewIt, while the current browser versions become replaced by newer ones.

Compatibility with older versions of Internet Explorer, Safari, Android Browser and Node.js is stable and not expected to change until the next major release of JScrewIt.

Known Limitations

Despite claims from other sources, not every piece of JavaScript can be converted into JSFuck. Some intrinsic limitations of the language make the code generated by JScrewIt unusable under certain conditions.

Modules

JScrewIt is designed to encode JavaScript scripts, as opposed to modules. Many module related features don't work at all in JSFuck: import and export statements in EcmaScript modules or usages of the require API in CommonJS modules cannot be encoded and are not supported.

Altered Global Objects

JavaScript libraries that manipulate global objects and functions can easily break the code generated by JScrewIt. There are many of them, so expect incompatibilities when working with third party tools.

Stack Trace Inspection

Stack traces thrown in encoded source files look different and may as well include frames not expected by the original code. For this reason, code that relies on stack trace inspection may no longer work after being converted.

Interesting Links

Package Sidebar

Install

npm i jscrewit

Homepage

jscrew.it

Weekly Downloads

68

Version

2.36.0

License

ISC

Unpacked Size

631 kB

Total Files

28

Last publish

Collaborators

  • fasttime