start up engine, please wait ...
- -
-
-
-
-
-
- Safe Chat @PACKAGE_VERSION@
-
- [unknown]
- 
-
-
-
-
-
-
-
-
-
-
-
diff --git a/html/login.php b/html/login.php
deleted file mode 100644
index 2ffee3a..0000000
--- a/html/login.php
+++ /dev/null
@@ -1,49 +0,0 @@
-real_escape_string($user);
- $pubkey = $db->real_escape_string($pubkey);
- $q = $db->query("select * from user where name='$user' and pubkey='$pubkey';");
- if (!$q) error("database query failed");
- if ($q->num_rows==1) {
- success("user $user found on server");
- } elseif ($q->num_rows==0) {
- $q = $db->query("insert into user (name, pubkey) values ('$user', '$pubkey');");
- if (!$q) error("creation of user failed");
- success("user $user created on server");
- } else {
- error("server database defect");
- }
- } catch (Exception $e) {
- error("login failed");
- }
-}
-login($_REQUEST['user'], $_REQUEST['pubkey']);
-?>
diff --git a/html/makefile.am b/html/makefile.am
deleted file mode 100644
index bf6cd82..0000000
--- a/html/makefile.am
+++ /dev/null
@@ -1,21 +0,0 @@
-## @id $Id$
-
-## 1 2 3 4 5 6 7 8
-## 45678901234567890123456789012345678901234567890123456789012345678901234567890
-
-wwwdir = ${pkgdatadir}/html
-dist_www_DATA = index.html chat.html newuser.html safechat.js \
- jquery.js openpgp.js jquery.cssemoticons.js \
- safechat.css jquery.cssemoticons.css checknewuser.php \
- get.php login.php pubkey.php send.php abort.svg \
- A-Tone-His_Self-1266414414.mp3 attachment.svg \
- audio.svg chat-rodrigo-angleton.svg \
- Checkout-Scanner-Beep-SoundBible.com-593325210-by-Mike-Koenig.mp3 \
- envelope.svg functions.php menu.svg pfeil.svg \
- photo.png photo.svg safechat-rodrigo-angleton.svg \
- safe-mimooh.svg send.svg update-messages.js video.png \
- video.svg opendb.php schema.sql
-
-EXTRA_DIST = documentation.dox
-
-MAINTAINERCLEANFILES = makefile.in
diff --git a/html/newuser.html b/html/newuser.html
deleted file mode 100644
index 7d91d20..0000000
--- a/html/newuser.html
+++ /dev/null
@@ -1,15 +0,0 @@
-Register User
-All you need to start is a username and a password:
- -Please chose any username, e.g. a pseudonym, your e-mail, your phone number, your real name, and chose a safe password.
-What is Safe Chat?
-Safe Chat is a chat program to protect your privacy. It is designed to be extremely easy to use, with all cool features, but with highest security through strong encryption. For more information, open «About Safe Chat» in the menu () above.
Never forget your Password!
-This messenger is absolutely secure. But on the other hand, that means, no one except you knows your password. No one can read your messages exept you, not even our administrator. It is technically impossible to restore a password. You would have to delete your account and create a new one. In that case, all messages are lost.
-Keys and Password
-Safe Chat internally uses OpenPGP for public/private-key encryption. Your password is not transfered to the server and not stored, it is used only to create and encrypt your private key. There are two keys, a secret private key, that is stored in the browser (or app) on your computer, encrypted with your password and not sent to the server. There is also public key, which is sent to the server and used by other users to encrypt messages that only you can read. You can backup and restore your keys and setings to and from a file. This is the only way to transfer your account to another browser or to computer. Do not delete your browser's local storage unless you have backed up your keys.
diff --git a/html/opendb.php b/html/opendb.php deleted file mode 100644 index e516dfb..0000000 --- a/html/opendb.php +++ /dev/null @@ -1,42 +0,0 @@ -query("create database if not exists safechat;"); - if (!$db) error("cannot create database"); - $db->select_db("safechat"); - if (!$db) error("cannot select database"); - $query = file_get_contents("schema.sql"); - if (!$query) error("cannot load database schema"); - foreach (split(";\n", $query) as $create) { - if ($create) { - $db->query($create); - if (!$db) error("cannot create database tables"); - } - } -} catch (Exception $e) { - error('database error on server: '+$e->getMessage()); -} -?> diff --git a/html/photo.png b/html/photo.png deleted file mode 100644 index baa033d..0000000 Binary files a/html/photo.png and /dev/null differ diff --git a/html/pubkey.php b/html/pubkey.php deleted file mode 100644 index f1a2b77..0000000 --- a/html/pubkey.php +++ /dev/null @@ -1,44 +0,0 @@ -real_escape_string($user); - $q = $db->query("select pubkey from user where name='$user';"); - /* if ($q->num_rows!=1 && $user=="safechat") { */ - /* require_once("optionstable.php"); */ - /* createSafechatUser(); */ - /* $q = $db->query("select pubkey from user where name='$user';"); */ - /* } */ - if ($q->num_rows==1) { - echo json_encode($q->fetch_row()[0]); - } else { - echo json_encode(null); - } - } catch (Exception $e) { - echo json_encode(null); - } -} -pubkey($_REQUEST['user']); -?> diff --git a/html/safechat.js b/html/safechat.js deleted file mode 100644 index 9d89bb5..0000000 --- a/html/safechat.js +++ /dev/null @@ -1,722 +0,0 @@ -/*! @file - - @id $Id$ - - This is the main application as it is fully run in the user's browser. - - @dot - digraph X { - - start [URL="\ref start()"]; - newuser [URL="\ref newuser()"]; - login [URL="\ref login()"]; - createkeypair [URL="\ref createkeypair()"]; - chat [URL="\ref chat()"]; - getpwd [URL="\ref getpwd()"]; - setpw [URL="\ref setpw()"]; - get [URL="\ref get()"]; - sendmessage [URL="\ref sendmessage()"]; - - start -> newuser [label="if no keys exist"]; - start -> login [label="if keys exist"]; - newuser -> createkeypair [label="on submit"]; - createkeypair -> "openpgp.generateKeyPair"; - "openpgp.generateKeyPair" -> login [label="keys generated in local store"]; - login -> chat [label="user is valid on server"]; - chat -> getpwd [label="password not yet entered"]; - getpwd -> setpw [label="on input"]; - setpw -> chat [label="password is valid"]; - chat -> chat [label="remain in chat"]; - chat -> get [label="start timer"]; - get -> get [label="restart timer"]; - chat -> sendmessage [label="on submit"]; - sendmessage -> chat [label="remain in chat"]; - } - @enddot -*/ -// 1 2 3 4 5 6 7 8 -// 45678901234567890123456789012345678901234567890123456789012345678901234567890 - -var password = null; ///< password, only stored temporary, until reload -var username = null; ///< username, only used during registration -var filecontent = new Array(); ///< temporary storage for attachments - -/// Show error messsage -/** Fades in an error message and logs to console. - @param data (optional) The error can be a string or any structure. - Strings are shown to the user, structures are logged only. - @param stay (optional) If not given as @c true, reloads page after 5s. */ -function error(data, stay) { - $("#status").fadeOut("slow", function() { - $("#status").addClass("error") - $("#status").removeClass("notice") - $("#status").removeClass("success") - if (data) { - if (typeof data == 'string') { - $("#status").html(data); - console.log("error: "+data); - } else { - $("#status").html('unknown error: '+JSON.stringify(data)); - console.log("error: "+JSON.stringify(data)); - } - } else { - $("#status").html('error'); - console.log("error"); - } - $("#status").fadeIn("slow"); - if (!stay) setTimeout(start, 5000); - }); -} - -/// Show notice messsage -/** Fades in an notice message and logs to console. - @param text (optional) The data is a string. */ -function notice(text) { - $("#status").fadeOut("slow", function() { - $("#status").addClass("notice") - $("#status").removeClass("error") - $("#status").removeClass("success") - if (text) { - $("#status").html(text); - console.log("notice: "+text); - } else { - $("#status").html(''); - console.log("notice"); - } - $("#status").fadeIn("slow"); - }); -} - -/// Show notice messsage -/** Fades in an success message and logs to console. - @param text (optional) The data is a string. */ -function success(text) { - $("#status").fadeOut("slow", function() { - $("#status").addClass("success") - $("#status").removeClass("error") - $("#status").removeClass("notice") - if (text) { - $("#status").html(text); - console.log("success: "+text); - } else { - $("#status").html(''); - console.log("success"); - } - $("#status").fadeIn("slow"); - }); -} - -/// Show status message in the main screen area -/** @param text Text is a message or some complex HTML from the server. - @param msg The success message text */ -function status(text, msg) { - $("#main").fadeOut("slow", function() { - $("#main").html(text); - if (msg) success(msg); - else setTimeout("$('#status').fadeOut('slow')", 5000); - $("#main").fadeIn("slow", function() { - $("form input:first-child").focus(); - }) - }); -} - -var getLoopTimeout = null; ///< store get timeout to make sure only one is running -/// Set timeout for next get request -/** @param time timeout time in ms, defaults to 10000 */ -function getLoop(time) { - if (!time) time = 10000; - getLoopStop(); - getLoopTimeout = setTimeout(get, time); -} -/// Stop get loop if it is running -function getLoopStop() { - if (getLoopTimeout) clearTimeout(getLoopTimeout); - getLoopTimeout = null; -} - -/// Alert user -/** Alert user, e.g. that a new message has arrived. */ -function alert() { - navigator.vibrate = - navigator.vibrate || navigator.webkitVibrate || navigator.mozVibrate || navigator.msVibrate; - if (navigator.vibrate) { - // vibration API supported - navigator.vibrate(1000); - } - (new Audio("A-Tone-His_Self-1266414414.mp3")).play(); -} - -/// Toggle Menu Display -function togglemenu() { - $("#menu").toggle(); -} - -/// Download Profile Backup -function backup() { - getLoopStop(); - status("Starting backup download ...
", ""); - var download = document.createElement('a'); - download.href = 'data:attachment/text,'+encodeURI(JSON.stringify(localStorage)); - download.target = '_blank'; - function pad(n) {return n<10 ? '0'+n : n} - var now = new Date(); - download.download = - pad(now.getFullYear())+pad(now.getMonth()+1)+pad(now.getDate())+ - "-"+userid()+"@"+window.location.hostname+".bak"; - var clickEvent = new MouseEvent("click", { - "view": window, - "bubbles": true, - "cancelable": false - }); - download.dispatchEvent(clickEvent); - togglemenu(); - setTimeout(start, 2000); -} - -/// Upload Profile Backup -function restore(evt) { - getLoopStop(); - status("Starting backup restore ...
", ""); - if (!window.FileReader) - return error("your browser dows not support file upload", true); - for (var i=0, f; f=evt.target.files[i]; ++i) { - var file = f; - var reader = new FileReader(); - reader.onload = function(evt) { - if (evt.target.error) return error("error reading file", true); - if (evt.target.readyState==0) return notice("waiting for data ..."); - if (evt.target.readyState==1) return notice("loading data ..."); - var parsed=JSON.parse(evt.target.result); - togglemenu(); - localStorage.pubKey = parsed.pubKey; - localStorage.privKey = parsed.privKey; - setTimeout(start, 2000); - } - reader.readAsText(file); - } -} - -/// Configure local groups -/** ... */ -function groups() { -} - -/// Check if user name is available -/** Calls checknewuser.php on server and displays an error, if the - user name is already in use. This function is used when creating a - new user. It immediately gives the user a feedback, whether the - chosen user name is available or not. - - Called when user edits the user name fields. - - Sets @ref username and checks @ref password - if both are well - defined, enables the submit button. - - @param user User name to check. */ -function checkuser(user) { - $("#register").submit(function(event) { - return false; - }); - $.post("checknewuser.php", {user: user}) - .done(function(res) { - username=JSON.parse(res); - if (!username||username.length<1) username=null; - $("#createuser").prop("disabled", !(username && password)); - if (username) { - if (password) success("user is ready to be created"); - else notice("user name is available, please set password"); - } else notice("user name is not available"); - }).fail(function(res) { - username=null; - $("#createuser").prop("disabled", !(username && password)); - error("offline"); - }); -} - -/// Check if password is set and matches the repeated password -/** Checks if both passwords are identical and valid and gives - feedback to the user. - - Called when user edits the password fields. - - Sets @ref username and checks @ref password - if both are well - defined, enables the submit button. - - @param pwd The password. - @param pwd2 The repeated password. */ -function checkpwd(pwd, pwd2) { - $("#register").submit(function(event) { - return false; - }); - if (pwd==pwd2) password=pwd; - else password=null; - if (!password||password.length<1) password=null; - $("#createuser").prop("disabled", !(username && password)); - if (password) { - if (username) success("user is ready to be created"); - else notice("password matches, please chose a valid user name"); - } else notice("passwords don't match"); -} - -/// Checks if the receiver of a message exists on server. -/** Calls checknewuser.php on server and enables the message submit - button if the receiver of the message exists on the server. */ -function checkpartner(user) { - $("#chat").submit(function(event) { - return false; - }); - $.post("checknewuser.php", {user: user}) - .done(function(res) { - if (JSON.parse(res)) { - notice("receiver does not exist"); - $("#send").prop("disabled", true); - return; - } - $("#send").prop("disabled", false); - success("receiver exists"); - }).fail(function(res) { - error("offline", true); - $("#send").prop("disabled", true); - }); -} - -/// Create Local Public-/Private-Key Pair -/** Called if user has not yet his keys, just generates a new key pair. */ -function createkeypair(user, pwd) { - status("generate keys"); - openpgp.generateKeyPair({ - numBits: 4096, - userId: user, - passphrase: pwd - }).then(function(keyPair) { - success("keys generated"); - localStorage["pubKey"] = keyPair.publicKeyArmored; - localStorage["privKey"] = keyPair.privateKeyArmored; - login(); - }).catch(function(e) { - console.log(e.stack); - error("generating key pairs failed"); - }); -} - -/// Get Own Public Key -/** @return public key object */ -function publicKey() { - if (typeof localStorage["pubKey"] == 'undefined') return null; - return openpgp.key.readArmored(localStorage["pubKey"]); -} - -/// Get Own Private Key -/** @return private key object */ -function privateKey() { - if (typeof localStorage["privKey"] == 'undefined') return null; - return openpgp.key.readArmored(localStorage["privKey"]); -} - -/// Get Own User Name -/** Get user name as user id of first public key */ -function userid() { - if (!publicKey() || - publicKey().keys.length < 1 || - publicKey().keys[0].getUserIds().length < 1) return null - return publicKey().keys[0].getUserIds()[0]; -} - -/// Clear Message Text And Attachments -/** Does not remove the receiver's name */ -function clearmessage() { - filecontent = new Array(); - $('#preview').empty(); - $("#msg").val(""); - notice("message cleared"); -} - -/// Display Image Attachments -function attachments(files, id) { - if (files) files.forEach(function(file) { - if (file.content.length<100000) { - var img = document.createElement('img'); - img.src = file.content; - $(id).append(img); - } - }); -} - -/// Upload Attachment -/** Prepares attachment to be sent in a message. If the attachment is - an image, it resizes the image to 400px on the lager side. - - By now, only images are supported. - - Stores data in global variable @ref filecontent. */ -function fileupload(evt) { - if (!window.FileReader) - return error("your browser dows not support file upload", true); - for (var i=0, f; f=evt.target.files[i]; ++i) { - var file = f; - var reader = new FileReader(); - reader.onload = function(evt) { - if (evt.target.error) return error("error reading file", true); - if (evt.target.readyState==0) return notice("waiting for data ..."); - if (evt.target.readyState==1) return notice("loading data ..."); - if (!file.type.match('^image/')) - return error(file.name+": not an image", true); - var img = document.createElement("img"); - img.onload = function() { - var MAX = 400; - var width = img.width; - var height = img.height; - if (width > MAX) { - height *= MAX / width; - width = MAX; - } - if (height > MAX) { - width *= MAX / height; - height = MAX; - } - var canvas = document.createElement("canvas"); - canvas.width = width; - canvas.height = height; - var ctx = canvas.getContext("2d"); - ctx.drawImage(img, 0, 0, width, height); - img.onload = function() { - filecontent.push({type: file.type, content: img.src}); - $("#preview").append(img); - success('image of type '+file.type+' is ready to be sent'); - } - img.src = canvas.toDataURL(file.type); - } - img.src=evt.target.result; - } - reader.readAsDataURL(file); - } -} - -/// Sets Receiver's Name -/** Called when clicked on a receiver's name. Sets focus to the - message text field. - - @param name The receiver's name. */ -function setreceiver(name) { - $("#recv").val(name); - checkpartner(name); - $("#msg").focus(); -} - -var userMap = null; -/// Get a user's public key. -/** The first time, gets it from the server, later from the cache. */ -function getPublicKey(user) { - var deferredObject = $.Deferred(); - if (userMap == null) { - if (localStorage.userMap) { - userMap = JSON.parse(localStorage.userMap); - console.log("got userMap from localStorage"); - } else { - userMap = new Array(); - } - } - if (userMap[user]) { - console.log("user "+user+" is in cache"); - deferredObject.resolve(userMap[user]); - } else { - $.post("pubkey.php", {user: user}) // get sender's key - .done(function(pk) { - console.log("got user "+user+" from server"); - userMap[user] = pk; - localStorage.userMap = JSON.stringify(userMap); - deferredObject.resolve(pk); - }).fail(function(e) { - error("offline"); - deferredObject.reject(e); - }); - } - return deferredObject.promise(); -} - -var startmsg = 0; ///< number of last downloaded message -/// Poll For New Messages, Get And Show Them -/** The global variable @ref startmsg stores the id of the last - downloaded message. This function is called by timer in regulary - periods. It calls get on server and passes @ref startmsg. The - server returns all newer messages. They are then decrypted. If - decryption is successful, then the message is shown, including - attachments. If decryption fails, the message is sent to someone - else, so failure is simply ignored. Beeps a sound once, if new - messages have been displayed. */ -function get() { - var beeped = false; // beep only once - $.post("get.php", {start: startmsg}) - .done(function(res) { // new messages from server received - var msgs = JSON.parse(res); - if (msgs) { - msgs.forEach(function(e) { // one single message - if (startmsg'+
- ''+
- (new Date(1000*Number(e.time))).toLocaleString()+
- ''+
- ''+
- e.user+
- ''+(message.receiver?" → "+message.receiver:"")+
- '
'+
- ''+
- message.text+
- '
');
- // show attachments
- attachments(message.files, '#id'+e.id+' .text');
- // calculate and show emoticons
- $('#id'+e.id).emoticonize();
- // beep for the first new message
- if (!beeped) alert()
- beeped = true;
- success();
- })
- .catch(function(e) {
- // not for me
- success();
- });
- }).fail(function(e) {
- error("offline");
- });
- });
- }
- }).fail(function(e) {
- error("offline")
- });
- getLoop(); // repeat every 10 seconds
-}
-
-/// Send Message To Server
-/** User wants to send a message. Encrypt message with own private and
- the receiver's public key, then send it to the server. */
-function sendmessage(recv, txt) {
- notice("1/3 preparing message ...");
- $("#message").fadeOut("slow");
- getPublicKey(recv) // get receiver's public key
- .done(function(pk) {
- var res=JSON.parse(pk);
- var key=openpgp.key.readArmored(res);
- if (!res||key.err) {
- $("#message").fadeIn("slow");
- error("receiver's key not found", true);
- return;
- }
- var privkey = privateKey().keys[0];
- privkey.decrypt(password); // get own private key ready
- var message = JSON.stringify({receiver: recv, text: txt, files: filecontent});
- notice("2/3 encrypting message ...");
- openpgp.signAndEncryptMessage(key.keys.concat(publicKey().keys), privkey, message)
- .then(function(msg) { // message is encrypted
- notice("3/3 sending message ...");
- $.post("send.php", {user: userid(), msg: msg})
- .done(function(res) { // message has been sent to server
- var st = JSON.parse(res);
- if (st.success) {
- $("#message").fadeIn("slow");
- clearmessage();
- success(st.txt);
- } else {
- $("#message").fadeIn("slow");
- error(st.txt, true);
- }
- })
- .fail(function() {
- error("offline", true);
- });
- })
- .catch(function(e) {
- $("#message").fadeIn("slow");
- error("encryption of message failed", true);
- });
- })
- .fail(function(e) {
- $("#message").fadeIn("slow");
- error("offline", true);
- });
- $("#message").fadeIn("slow");
-}
-
-/// Check And Set Password
-/** Check if given password matches to decrypt the private key. If so,
- store it in global temporary variable @ref password and start the
- chat. The password matches, when the private key can be decrypted.
-
- @param pwd The password to check. */
-function setpw(pwd) {
- if (privateKey().keys[0].decrypt(pwd)) {
- success("password matches");
- $("#removeKey").hide();
- password = pwd;
- chat();
- } else {
- notice("password does not match");
- }
-}
-
-/// Create Password Entry Field
-/** Asks user for password. When user starts to enter it, it is
- permanentely checked in setpw(). As soon as the password matches,
- setpw() continues automatically. No submit is required by the
- user. */
-function getpwd() {
- $("#removeKey").show();
- status('');
-}
-
-function deleteUser() {
- var uid = userid();
- localStorage.pubKey = null;
- localStorage.privKey = null;
- error("user "+uid+" permanentely lost");
- status("Deleted User: "+uid);
-}
-
-function removeKey() {
- togglemenu();
- $("#removeKey").hide();
- status('Password Forgotten
'+ - 'Warning!'+
- '
'+
- '- You loose all messages. '+ - '
- You loose your account name «'+userid()+'». '+ - '
- You should backup now, before you continue!
You can only remove your local data. '+ - 'You will have to create a new account with a new name on the server. '+ - 'This means, you loose all your messages and you loose your account '+ - 'name «'+userid()+'» forever. '+ - 'This chat program is secure, nobody can restore your password. '+ - 'Without password, you can\'t prove, that you are «'+userid()+'».
'+ - '', ""); -} - -/// Main Chat Window -/** Gets chat widgets from server and displays them. Starts timer for - get() which polls for new messages. */ -function chat() { - $("#username").html(userid()+"@"+window.location.hostname); - if (!password) return getpwd(); - $.ajax({url: "chat.html", success: function(res) { - status(res); - getLoop(2000); - }}).fail(function() { - error("offline") - }); -} - -/// Login User -/** This is not really a login, it is just some kind of validation. - The server does not care if a user is online or not, it is only - interesting to the client to make sure, everything is fine. User - is logged in the following way: User name and public key are sent - to the server. If the user name exists on the server and the - public key is the same, the user is considered logged in, his - credentials seem to be valid. If user does not yet exits on - server, it is created now. If user exists, but public key is - different, then this is a complete failure, something went - terribly wrong. */ -function login() { - status("login ..."); - $.post("login.php", {user: userid(), - pubkey: localStorage.pubKey}, - function(res) { - var st = JSON.parse(res); - if (st.success) { - status("logged in ...", st.txt); - chat(); - } else { - error(st.txt); - } - }) - .fail(function(e) { - error("offline"); - }); -} - -/// Get And Display Form To Create New User -/** Shows user creation form. On submit, a private key is generated in - createkeypair(), then login() creates the user. */ -function newuser() { - status("new user ..."); - $.ajax({url: "newuser.html", success: function(res) { - status(res); - }}).fail(function() { - error("offline"); - }); -} - -/// Check if local storage is available -function checkLocalStorage() { - var test = 'test'; - try { - localStorage.setItem(test, test); - localStorage.removeItem(test); - return true; - } catch(e) { - status("No access to local storage. Please allow "+window.location.hostname - +" to access localhost, i.e. do not block cookies.
");
- error("local storage not available");
- }
- return false;
-}
-
-/// Initial Function: Startup
-/** Decide whether to login or to create a new user */
-function start() {
- $("#menu").hide();
- if (checkLocalStorage())
- try {
- status("Starting up ...");
- if (!userid()) {
- newuser();
- } else {
- login();
- }
- } catch (m) {
- console.log(m.stack);
- error(m);
- }
-}
-
-/// On Load, Call @ref start
-$(window.onbeforeunload = function() {
- return "Are you sure you want to navigate away?";
-});
-$(window.onunload = function() { // you probably don't want to leave now...
- alert('You are trying to leave.');
- return false;
-});
-/// Allow Running in Background on Android
-document.addEventListener('deviceready', function () {
- if (cordova && cordova.plugins.backgroundMode) {
- cordova.plugins.backgroundMode.enable();
- }
-}, false);
-
-/// Start Main Loop
-$(start);
-
diff --git a/html/send.php b/html/send.php
deleted file mode 100644
index 5505ad0..0000000
--- a/html/send.php
+++ /dev/null
@@ -1,48 +0,0 @@
-real_escape_string($user);
- $msg = $db->real_escape_string($msg);
- if (strlen($_REQUEST['msg'])>100000) error("message is too long");
- $q = $db->query("select pubkey from user where name='$user';");
- if (!$q || $q->num_rows!=1) error("user not found on server");
- /*
- $pubkey = gnupg_import($pgp, $q->fetch_row()[0]);
- if (!$pubkey) error("wrong identity");
- */
- $q = $db->query("insert into message (user, msg) values ('$user', '$msg');");
- if (!$q) {
- error_log("Error storing message: ".$db->error);
- error("storing message failed");
- }
- success("message stored");
- } catch (Exception $e) {
- error_log("Error storing message: ".$e->message);
- error("storing message failed");
- }
-}
-send($_REQUEST['user'], $_REQUEST['msg']);
-?>
\ No newline at end of file
diff --git a/html/update-messages.js b/html/update-messages.js
deleted file mode 100644
index 202f1a8..0000000
--- a/html/update-messages.js
+++ /dev/null
@@ -1,40 +0,0 @@
-importScripts('jquery.js');
-importScripts('openpgp.js');
-
-function attachments(files) {
- var res = '';
- if (files) files.forEach(function(file) {
- if (file.type.match("^image/"))
- res += '';
- });
- return res;
-}
-
-addEventListener('message', function(data) {
- var e = data.e;
- var key = data.key;
- var message = openpgp.message.readArmored(e["msg"]);
- var privkey = privateKey().keys[0];
- if (privkey.decrypt(password))
- openpgp.decryptAndVerifyMessage(privkey, key.keys, message)
- .then(function(msg) {
- var message = JSON.parse(msg.text);
- // todo: check msg.signatures[0].valid
- postMessage('
'+
- ''+
- (new Date(1000*Number(e["time"]))).toLocaleString()+
- ''+
- ''+
- e["user"]+
- '
'+
- attachments(message.files)+
- ''+
- message.text+
- '
<%= user.name %>
+<% } %> +``` + +## Usage + +```javascript +var template = ejs.compile(str, options); +template(data); +// => Rendered HTML string + +ejs.render(str, data, options); +// => Rendered HTML string +``` + +You can also use the shortcut `ejs.render(dataAndOptions);` where you pass +everything in a single object. In that case, you'll end up with local variables +for all the passed options. + +## Options + + - `cache` Compiled functions are cached, requires `filename` + - `filename` Used by `cache` to key caches, and for includes + - `context` Function execution context + - `compileDebug` When `false` no debug instrumentation is compiled + - `client` Returns standalone compiled function + - `delimiter` Character to use with angle brackets for open/close + - `debug` Output generated function body + - `_with` Whether or not to use `with() {}` constructs. If `false` then the locals will be stored in the `locals` object. + - `rmWhitespace` Remove all safe-to-remove whitespace, including leading + and trailing whitespace. It also enables a safer version of `-%>` line + slurping for all scriptlet tags (it does not strip new lines of tags in + the middle of a line). + +## Tags + + - `<%` 'Scriptlet' tag, for control-flow, no output + - `<%=` Outputs the value into the template (HTML escaped) + - `<%-` Outputs the unescaped value into the template + - `<%#` Comment tag, no execution, no output + - `<%%` Outputs a literal '<%' + - `%>` Plain ending tag + - `-%>` Trim-mode ('newline slurp') tag, trims following newline + +## Includes + +Includes either have to be an absolute path, or, if not, are assumed as +relative to the template with the `include` call. (This requires the +`filename` option.) For example if you are including `./views/user/show.ejs` +from `./views/users.ejs` you would use `<%- include('user/show') %>`. + +You'll likely want to use the raw output tag (`<%-`) with your include to avoid +double-escaping the HTML output. + +```html +-
+ <% users.forEach(function(user){ %>
+ <%- include('user/show', {user: user}) %>
+ <% }); %>
+
+ Title +
++ My page +
+<%- include('footer') -%> +``` + +## Client-side support + +Go to the [Latest Release](https://github.com/mde/ejs/releases/latest), download +`./ejs.js` or `./ejs.min.js`. + +Include one of these on your page, and `ejs.render(str)`. + +## Related projects + +There are a number of implementations of EJS: + + * TJ's implementation, the v1 of this library: https://github.com/tj/ejs + * Jupiter Consulting's EJS: http://www.embeddedjs.com/ + * EJS Embedded JavaScript Framework on Google Code: https://code.google.com/p/embeddedjavascript/ + * Sam Stephenson's Ruby implementation: https://rubygems.org/gems/ejs + * Erubis, an ERB implementation which also runs JavaScript: http://www.kuwata-lab.com/erubis/users-guide.04.html#lang-javascript + +## License + +Licensed under the Apache License, Version 2.0 +(<%= user.name %>
\n<% } %>\n```\n\n## Usage\n\n```javascript\nvar template = ejs.compile(str, options);\ntemplate(data);\n// => Rendered HTML string\n\nejs.render(str, data, options);\n// => Rendered HTML string\n```\n\nYou can also use the shortcut `ejs.render(dataAndOptions);` where you pass\neverything in a single object. In that case, you'll end up with local variables\nfor all the passed options.\n\n## Options\n\n - `cache` Compiled functions are cached, requires `filename`\n - `filename` Used by `cache` to key caches, and for includes\n - `context` Function execution context\n - `compileDebug` When `false` no debug instrumentation is compiled\n - `client` Returns standalone compiled function\n - `delimiter` Character to use with angle brackets for open/close\n - `debug` Output generated function body\n - `_with` Whether or not to use `with() {}` constructs. If `false` then the locals will be stored in the `locals` object.\n - `rmWhitespace` Remove all safe-to-remove whitespace, including leading\n and trailing whitespace. It also enables a safer version of `-%>` line\n slurping for all scriptlet tags (it does not strip new lines of tags in\n the middle of a line).\n\n## Tags\n\n - `<%` 'Scriptlet' tag, for control-flow, no output\n - `<%=` Outputs the value into the template (HTML escaped)\n - `<%-` Outputs the unescaped value into the template\n - `<%#` Comment tag, no execution, no output\n - `<%%` Outputs a literal '<%'\n - `%>` Plain ending tag\n - `-%>` Trim-mode ('newline slurp') tag, trims following newline\n\n## Includes\n\nIncludes either have to be an absolute path, or, if not, are assumed as\nrelative to the template with the `include` call. (This requires the\n`filename` option.) For example if you are including `./views/user/show.ejs`\nfrom `./views/users.ejs` you would use `<%- include('user/show') %>`.\n\nYou'll likely want to use the raw output tag (`<%-`) with your include to avoid\ndouble-escaping the HTML output.\n\n```html\n- \n <% users.forEach(function(user){ %>\n <%- include('user/show', {user: user}) %>\n <% }); %>\n
\n Title\n
\n\n My page\n
\n<%- include('footer') -%>\n```\n\n## Client-side support\n\nGo to the [Latest Release](https://github.com/mde/ejs/releases/latest), download\n`./ejs.js` or `./ejs.min.js`.\n\nInclude one of these on your page, and `ejs.render(str)`.\n\n## Related projects\n\nThere are a number of implementations of EJS:\n\n * TJ's implementation, the v1 of this library: https://github.com/tj/ejs\n * Jupiter Consulting's EJS: http://www.embeddedjs.com/\n * EJS Embedded JavaScript Framework on Google Code: https://code.google.com/p/embeddedjavascript/\n * Sam Stephenson's Ruby implementation: https://rubygems.org/gems/ejs\n * Erubis, an ERB implementation which also runs JavaScript: http://www.kuwata-lab.com/erubis/users-guide.04.html#lang-javascript\n\n## License\n\nLicensed under the Apache License, Version 2.0\n(yay
'); + assert.equal(fn(), 'yay
'); + }); + + test('empty input works', function () { + var fn = ejs.compile(''); + assert.equal(fn(), ''); + }); + + test('throw if there are syntax errors', function () { + try { + ejs.compile(fixture('fail.ejs')); + } + catch (err) { + assert.ok(err.message.indexOf('compiling ejs') > -1); + + try { + ejs.compile(fixture('fail.ejs'), {filename: 'fail.ejs'}); + } + catch (err) { + assert.ok(err.message.indexOf('fail.ejs') > -1); + return; + } + } + throw new Error('no error reported when there should be'); + }); + + test('allow customizing delimiter local var', function () { + var fn; + fn = ejs.compile('', {delimiter: '?'}); + assert.equal(fn({name: 'geddy'}), 'geddy
'); + + fn = ejs.compile('<:= name :>
', {delimiter: ':'}); + assert.equal(fn({name: 'geddy'}), 'geddy
'); + + fn = ejs.compile('<$= name $>
', {delimiter: '$'}); + assert.equal(fn({name: 'geddy'}), 'geddy
'); + }); + + test('default to using ejs.delimiter', function () { + var fn; + ejs.delimiter = '&'; + fn = ejs.compile('<&= name &>
'); + assert.equal(fn({name: 'geddy'}), 'geddy
'); + + fn = ejs.compile('<|= name |>
', {delimiter: '|'}); + assert.equal(fn({name: 'geddy'}), 'geddy
'); + delete ejs.delimiter; + }); + + test('have a working client option', function () { + var fn + , str + , preFn; + fn = ejs.compile('<%= foo %>
', {client: true}); + str = fn.toString(); + if (!process.env.running_under_istanbul) { + eval('var preFn = ' + str); + assert.equal(preFn({foo: 'bar'}), 'bar
'); + } + }); + + test('support client mode without locals', function () { + var fn + , str + , preFn; + fn = ejs.compile('<%= "foo" %>
', {client: true}); + str = fn.toString(); + if (!process.env.running_under_istanbul) { + eval('var preFn = ' + str); + assert.equal(preFn(), 'foo
'); + } + }); + + test('not include rethrow() in client mode if compileDebug is false', function () { + var fn = ejs.compile('<%= "foo" %>
', { + client: true + , compileDebug: false + }); + // There could be a `rethrow` in the function declaration + assert((fn.toString().match(/rethrow/g) || []).length <= 1); + }); +}); + +suite('ejs.render(str, data, opts)', function () { + test('render the template', function () { + assert.equal(ejs.render('yay
'), 'yay
'); + }); + + test('empty input works', function () { + assert.equal(ejs.render(''), ''); + }); + + test('undefined renders nothing escaped', function () { + assert.equal(ejs.render('<%= undefined %>'), ''); + }); + + test('undefined renders nothing raw', function () { + assert.equal(ejs.render('<%- undefined %>'), ''); + }); + + test('null renders nothing escaped', function () { + assert.equal(ejs.render('<%= null %>'), ''); + }); + + test('null renders nothing raw', function () { + assert.equal(ejs.render('<%- null %>'), ''); + }); + + test('zero-value data item renders something escaped', function () { + assert.equal(ejs.render('<%= 0 %>'), '0'); + }); + + test('zero-value data object renders something raw', function () { + assert.equal(ejs.render('<%- 0 %>'), '0'); + }); + + test('accept locals', function () { + assert.equal(ejs.render('<%= name %>
', {name: 'geddy'}), + 'geddy
'); + }); + + test('accept locals without using with() {}', function () { + assert.equal(ejs.render('<%= locals.name %>
', {name: 'geddy'}, + {_with: false}), + 'geddy
'); + assert.throws(function() { + ejs.render('<%= name %>
', {name: 'geddy'}, + {_with: false}); + }, /name is not defined/); + }); + + test('accept custom name for locals', function () { + ejs.localsName = 'it'; + assert.equal(ejs.render('<%= it.name %>
', {name: 'geddy'}, + {_with: false}), + 'geddy
'); + assert.throws(function() { + ejs.render('<%= name %>
', {name: 'geddy'}, + {_with: false}); + }, /name is not defined/); + ejs.localsName = 'locals'; + }); + + test('support caching', function () { + var file = __dirname + '/tmp/render.ejs' + , options = {cache: true, filename: file} + , out = ejs.render('Old
', {}, options) + , expected = 'Old
'; + assert.equal(out, expected); + // Assert no change, still in cache + out = ejs.render('New
', {}, options); + assert.equal(out, expected); + }); + + test('support LRU caching', function () { + var oldCache = ejs.cache + , file = __dirname + '/tmp/render.ejs' + , options = {cache: true, filename: file} + , out + , expected = 'Old
'; + + // Switch to LRU + ejs.cache = LRU(); + + out = ejs.render('Old
', {}, options); + assert.equal(out, expected); + // Assert no change, still in cache + out = ejs.render('New
', {}, options); + assert.equal(out, expected); + + // Restore system cache + ejs.cache = oldCache; + }); + + test('opts.context', function () { + var ctxt = {foo: 'FOO'} + , out = ejs.render('<%= this.foo %>', {}, {context: ctxt}); + assert.equal(out, ctxt.foo); + }); +}); + +suite('ejs.renderFile(path, [data], [options], fn)', function () { + test('render a file', function(done) { + ejs.renderFile('test/fixtures/para.ejs', function(err, html) { + if (err) { + return done(err); + } + assert.equal(html, 'hey
\n'); + done(); + }); + }); + + test('accept locals', function(done) { + var data = {name: 'fonebone'} + , options = {delimiter: '$'}; + ejs.renderFile('test/fixtures/user.ejs', data, options, function(err, html) { + if (err) { + return done(err); + } + assert.equal(html, 'fonebone
\n'); + done(); + }); + }); + + test('accept locals without using with() {}', function(done) { + var data = {name: 'fonebone'} + , options = {delimiter: '$', _with: false} + , doneCount = 0; + ejs.renderFile('test/fixtures/user-no-with.ejs', data, options, + function(err, html) { + if (err) { + if (doneCount === 2) { + return; + } + doneCount = 2; + return done(err); + } + assert.equal(html, 'fonebone
\n'); + doneCount++; + if (doneCount === 2) { + done(); + } + }); + ejs.renderFile('test/fixtures/user.ejs', data, options, function(err) { + if (!err) { + if (doneCount === 2) { + return; + } + doneCount = 2; + return done(new Error('error not thrown')); + } + doneCount++; + if (doneCount === 2) { + done(); + } + }); + }); + + test('not catch err thrown by callback', function(done) { + var data = {name: 'fonebone'} + , options = {delimiter: '$'} + , counter = 0; + + var d = require('domain').create(); + d.on('error', function (err) { + assert.equal(counter, 1); + assert.equal(err.message, 'Exception in callback'); + done(); + }); + d.run(function () { + // process.nextTick() needed to work around mochajs/mocha#513 + // + // tl;dr: mocha doesn't support synchronous exception throwing in + // domains. Have to make it async. Ticket closed because: "domains are + // deprecated :D" + process.nextTick(function () { + ejs.renderFile('test/fixtures/user.ejs', data, options, + function(err) { + counter++; + if (err) { + assert.notEqual(err.message, 'Exception in callback'); + return done(err); + } + throw new Error('Exception in callback'); + }); + }); + }); + }); + + test('support caching', function (done) { + var expected = 'Old
' + , file = __dirname + '/tmp/renderFile.ejs' + , options = {cache: true}; + fs.writeFileSync(file, 'Old
'); + + ejs.renderFile(file, {}, options, function (err, out) { + if (err) { + done(err); + } + fs.writeFileSync(file, 'New
'); + assert.equal(out, expected); + + ejs.renderFile(file, {}, options, function (err, out) { + if (err) { + done(err); + } + // Assert no change, still in cache + assert.equal(out, expected); + done(); + }); + }); + }); + + test('opts.context', function (done) { + var ctxt = {foo: 'FOO'}; + ejs.renderFile('test/fixtures/with-context.ejs', {}, + {context: ctxt}, function(err, html) { + if (err) { + return done(err); + } + assert.equal(html, ctxt.foo + '\n'); + done(); + }); + + }); +}); + +suite('cache specific', function () { + test('`clearCache` work properly', function () { + var expected = 'Old
' + , file = __dirname + '/tmp/clearCache.ejs' + , options = {cache: true, filename: file} + , out = ejs.render('Old
', {}, options); + assert.equal(out, expected); + + ejs.clearCache(); + + expected = 'New
'; + out = ejs.render('New
', {}, options); + assert.equal(out, expected); + }); + + test('`clearCache` work properly, LRU', function () { + var expected = 'Old
' + , oldCache = ejs.cache + , file = __dirname + '/tmp/clearCache.ejs' + , options = {cache: true, filename: file} + , out; + + ejs.cache = LRU(); + + out = ejs.render('Old
', {}, options); + assert.equal(out, expected); + ejs.clearCache(); + expected = 'New
'; + out = ejs.render('New
', {}, options); + assert.equal(out, expected); + + ejs.cache = oldCache; + }); + + test('LRU with cache-size 1', function () { + var oldCache = ejs.cache + , options + , out + , expected + , file; + + ejs.cache = LRU(1); + + file = __dirname + '/tmp/render1.ejs'; + options = {cache: true, filename: file}; + out = ejs.render('File1
', {}, options); + expected = 'File1
'; + assert.equal(out, expected); + + // Same filename, different template, but output + // should be the same because cache + file = __dirname + '/tmp/render1.ejs'; + options = {cache: true, filename: file}; + out = ejs.render('ChangedFile1
', {}, options); + expected = 'File1
'; + assert.equal(out, expected); + + // Different filiename -- output should be different, + // and previous cache-entry should be evicted + file = __dirname + '/tmp/render2.ejs'; + options = {cache: true, filename: file}; + out = ejs.render('File2
', {}, options); + expected = 'File2
'; + assert.equal(out, expected); + + // Entry with first filename should now be out of cache, + // results should be different + file = __dirname + '/tmp/render1.ejs'; + options = {cache: true, filename: file}; + out = ejs.render('ChangedFile1
', {}, options); + expected = 'ChangedFile1
'; + assert.equal(out, expected); + + ejs.cache = oldCache; + }); +}); + +suite('<%', function () { + test('without semicolons', function () { + assert.equal(ejs.render(fixture('no.semicolons.ejs')), + fixture('no.semicolons.html')); + }); +}); + +suite('<%=', function () { + test('escape & + + + +
+
+
+
\ No newline at end of file
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/error.html b/nodejs/node_modules/express/node_modules/connect/lib/public/error.html
new file mode 100644
index 0000000..34e0df5
--- /dev/null
+++ b/nodejs/node_modules/express/node_modules/connect/lib/public/error.html
@@ -0,0 +1,13 @@
+
+
+ {linked-path}
+ {files} +
+
+
+
\ No newline at end of file
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/favicon.ico b/nodejs/node_modules/express/node_modules/connect/lib/public/favicon.ico
new file mode 100644
index 0000000..895fc96
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/favicon.ico differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page.png
new file mode 100755
index 0000000..03ddd79
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_add.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_add.png
new file mode 100755
index 0000000..d5bfa07
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_add.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_attach.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_attach.png
new file mode 100755
index 0000000..89ee2da
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_attach.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_code.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_code.png
new file mode 100755
index 0000000..f7ea904
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_code.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_copy.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_copy.png
new file mode 100755
index 0000000..195dc6d
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_copy.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_delete.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_delete.png
new file mode 100755
index 0000000..3141467
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_delete.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_edit.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_edit.png
new file mode 100755
index 0000000..046811e
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_edit.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_error.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_error.png
new file mode 100755
index 0000000..f07f449
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_error.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_excel.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_excel.png
new file mode 100755
index 0000000..eb6158e
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_excel.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_find.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_find.png
new file mode 100755
index 0000000..2f19388
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_find.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_gear.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_gear.png
new file mode 100755
index 0000000..8e83281
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_gear.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_go.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_go.png
new file mode 100755
index 0000000..80fe1ed
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_go.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_green.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_green.png
new file mode 100755
index 0000000..de8e003
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_green.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_key.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_key.png
new file mode 100755
index 0000000..d6626cb
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_key.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_lightning.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_lightning.png
new file mode 100755
index 0000000..7e56870
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_lightning.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_link.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_link.png
new file mode 100755
index 0000000..312eab0
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_link.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_paintbrush.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_paintbrush.png
new file mode 100755
index 0000000..246a2f0
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_paintbrush.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_paste.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_paste.png
new file mode 100755
index 0000000..968f073
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_paste.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_red.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_red.png
new file mode 100755
index 0000000..0b18247
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_red.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_refresh.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_refresh.png
new file mode 100755
index 0000000..cf347c7
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_refresh.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_save.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_save.png
new file mode 100755
index 0000000..caea546
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_save.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white.png
new file mode 100755
index 0000000..8b8b1ca
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_acrobat.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_acrobat.png
new file mode 100755
index 0000000..8f8095e
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_acrobat.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_actionscript.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_actionscript.png
new file mode 100755
index 0000000..159b240
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_actionscript.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_add.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_add.png
new file mode 100755
index 0000000..aa23dde
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_add.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_c.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_c.png
new file mode 100755
index 0000000..34a05cc
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_c.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_camera.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_camera.png
new file mode 100755
index 0000000..f501a59
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_camera.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cd.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cd.png
new file mode 100755
index 0000000..848bdaf
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cd.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_code.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_code.png
new file mode 100755
index 0000000..0c76bd1
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_code.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_code_red.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_code_red.png
new file mode 100755
index 0000000..87a6914
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_code_red.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_coldfusion.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_coldfusion.png
new file mode 100755
index 0000000..c66011f
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_coldfusion.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_compressed.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_compressed.png
new file mode 100755
index 0000000..2b6b100
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_compressed.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_copy.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_copy.png
new file mode 100755
index 0000000..a9f31a2
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_copy.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cplusplus.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cplusplus.png
new file mode 100755
index 0000000..a87cf84
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cplusplus.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_csharp.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_csharp.png
new file mode 100755
index 0000000..ffb8fc9
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_csharp.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cup.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cup.png
new file mode 100755
index 0000000..0a7d6f4
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_cup.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_database.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_database.png
new file mode 100755
index 0000000..bddba1f
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_database.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_delete.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_delete.png
new file mode 100755
index 0000000..af1ecaf
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_delete.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_dvd.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_dvd.png
new file mode 100755
index 0000000..4cc537a
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_dvd.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_edit.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_edit.png
new file mode 100755
index 0000000..b93e776
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_edit.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_error.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_error.png
new file mode 100755
index 0000000..9fc5a0a
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_error.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_excel.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_excel.png
new file mode 100755
index 0000000..b977d7e
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_excel.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_find.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_find.png
new file mode 100755
index 0000000..5818436
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_find.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_flash.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_flash.png
new file mode 100755
index 0000000..5769120
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_flash.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_freehand.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_freehand.png
new file mode 100755
index 0000000..8d719df
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_freehand.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_gear.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_gear.png
new file mode 100755
index 0000000..106f5aa
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_gear.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_get.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_get.png
new file mode 100755
index 0000000..e4a1ecb
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_get.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_go.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_go.png
new file mode 100755
index 0000000..7e62a92
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_go.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_h.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_h.png
new file mode 100755
index 0000000..e902abb
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_h.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_horizontal.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_horizontal.png
new file mode 100755
index 0000000..1d2d0a4
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_horizontal.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_key.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_key.png
new file mode 100755
index 0000000..d616484
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_key.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_lightning.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_lightning.png
new file mode 100755
index 0000000..7215d1e
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_lightning.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_link.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_link.png
new file mode 100755
index 0000000..bf7bd1c
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_link.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_magnify.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_magnify.png
new file mode 100755
index 0000000..f6b74cc
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_magnify.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_medal.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_medal.png
new file mode 100755
index 0000000..d3fffb6
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_medal.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_office.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_office.png
new file mode 100755
index 0000000..a65bcb3
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_office.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paint.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paint.png
new file mode 100755
index 0000000..23a37b8
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paint.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paintbrush.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paintbrush.png
new file mode 100755
index 0000000..f907e44
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paintbrush.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paste.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paste.png
new file mode 100755
index 0000000..5b2cbb3
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_paste.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_php.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_php.png
new file mode 100755
index 0000000..7868a25
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_php.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_picture.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_picture.png
new file mode 100755
index 0000000..134b669
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_picture.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_powerpoint.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_powerpoint.png
new file mode 100755
index 0000000..c4eff03
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_powerpoint.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_put.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_put.png
new file mode 100755
index 0000000..884ffd6
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_put.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_ruby.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_ruby.png
new file mode 100755
index 0000000..f59b7c4
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_ruby.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_stack.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_stack.png
new file mode 100755
index 0000000..44084ad
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_stack.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_star.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_star.png
new file mode 100755
index 0000000..3a1441c
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_star.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_swoosh.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_swoosh.png
new file mode 100755
index 0000000..e770829
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_swoosh.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_text.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_text.png
new file mode 100755
index 0000000..813f712
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_text.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_text_width.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_text_width.png
new file mode 100755
index 0000000..d9cf132
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_text_width.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_tux.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_tux.png
new file mode 100755
index 0000000..52699bf
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_tux.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_vector.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_vector.png
new file mode 100755
index 0000000..4a05955
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_vector.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_visualstudio.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_visualstudio.png
new file mode 100755
index 0000000..a0a433d
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_visualstudio.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_width.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_width.png
new file mode 100755
index 0000000..1eb8809
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_width.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_word.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_word.png
new file mode 100755
index 0000000..ae8ecbf
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_word.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_world.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_world.png
new file mode 100755
index 0000000..6ed2490
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_world.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_wrench.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_wrench.png
new file mode 100755
index 0000000..fecadd0
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_wrench.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_zip.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_zip.png
new file mode 100755
index 0000000..fd4bbcc
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_white_zip.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_word.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_word.png
new file mode 100755
index 0000000..834cdfa
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_word.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_world.png b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_world.png
new file mode 100755
index 0000000..b8895dd
Binary files /dev/null and b/nodejs/node_modules/express/node_modules/connect/lib/public/icons/page_world.png differ
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/public/style.css b/nodejs/node_modules/express/node_modules/connect/lib/public/style.css
new file mode 100644
index 0000000..32b6507
--- /dev/null
+++ b/nodejs/node_modules/express/node_modules/connect/lib/public/style.css
@@ -0,0 +1,141 @@
+body {
+ margin: 0;
+ padding: 80px 100px;
+ font: 13px "Helvetica Neue", "Lucida Grande", "Arial";
+ background: #ECE9E9 -webkit-gradient(linear, 0% 0%, 0% 100%, from(#fff), to(#ECE9E9));
+ background: #ECE9E9 -moz-linear-gradient(top, #fff, #ECE9E9);
+ background-repeat: no-repeat;
+ color: #555;
+ -webkit-font-smoothing: antialiased;
+}
+h1, h2, h3 {
+ margin: 0;
+ font-size: 22px;
+ color: #343434;
+}
+h1 em, h2 em {
+ padding: 0 5px;
+ font-weight: normal;
+}
+h1 {
+ font-size: 60px;
+}
+h2 {
+ margin-top: 10px;
+}
+h3 {
+ margin: 5px 0 10px 0;
+ padding-bottom: 5px;
+ border-bottom: 1px solid #eee;
+ font-size: 18px;
+}
+ul {
+ margin: 0;
+ padding: 0;
+}
+ul li {
+ margin: 5px 0;
+ padding: 3px 8px;
+ list-style: none;
+}
+ul li:hover {
+ cursor: pointer;
+ color: #2e2e2e;
+}
+ul li .path {
+ padding-left: 5px;
+ font-weight: bold;
+}
+ul li .line {
+ padding-right: 5px;
+ font-style: italic;
+}
+ul li:first-child .path {
+ padding-left: 0;
+}
+p {
+ line-height: 1.5;
+}
+a {
+ color: #555;
+ text-decoration: none;
+}
+a:hover {
+ color: #303030;
+}
+#stacktrace {
+ margin-top: 15px;
+}
+.directory h1 {
+ margin-bottom: 15px;
+ font-size: 18px;
+}
+ul#files {
+ width: 100%;
+ height: 500px;
+}
+ul#files li {
+ padding: 0;
+}
+ul#files li img {
+ position: absolute;
+ top: 5px;
+ left: 5px;
+}
+ul#files li a {
+ position: relative;
+ display: block;
+ margin: 1px;
+ width: 30%;
+ height: 25px;
+ line-height: 25px;
+ text-indent: 8px;
+ float: left;
+ border: 1px solid transparent;
+ -webkit-border-radius: 5px;
+ -moz-border-radius: 5px;
+ border-radius: 5px;
+ overflow: hidden;
+ text-overflow: ellipsis;
+}
+ul#files li a.icon {
+ text-indent: 25px;
+}
+ul#files li a:focus,
+ul#files li a:hover {
+ outline: none;
+ background: rgba(255,255,255,0.65);
+ border: 1px solid #ececec;
+}
+ul#files li a.highlight {
+ -webkit-transition: background .4s ease-in-out;
+ background: #ffff4f;
+ border-color: #E9DC51;
+}
+#search {
+ display: block;
+ position: fixed;
+ top: 20px;
+ right: 20px;
+ width: 90px;
+ -webkit-transition: width ease 0.2s, opacity ease 0.4s;
+ -moz-transition: width ease 0.2s, opacity ease 0.4s;
+ -webkit-border-radius: 32px;
+ -moz-border-radius: 32px;
+ -webkit-box-shadow: inset 0px 0px 3px rgba(0, 0, 0, 0.25), inset 0px 1px 3px rgba(0, 0, 0, 0.7), 0px 1px 0px rgba(255, 255, 255, 0.03);
+ -moz-box-shadow: inset 0px 0px 3px rgba(0, 0, 0, 0.25), inset 0px 1px 3px rgba(0, 0, 0, 0.7), 0px 1px 0px rgba(255, 255, 255, 0.03);
+ -webkit-font-smoothing: antialiased;
+ text-align: left;
+ font: 13px "Helvetica Neue", Arial, sans-serif;
+ padding: 4px 10px;
+ border: none;
+ background: transparent;
+ margin-bottom: 0;
+ outline: none;
+ opacity: 0.7;
+ color: #888;
+}
+#search:focus {
+ width: 120px;
+ opacity: 1.0;
+}
diff --git a/nodejs/node_modules/express/node_modules/connect/lib/utils.js b/nodejs/node_modules/express/node_modules/connect/lib/utils.js
new file mode 100644
index 0000000..d0bc172
--- /dev/null
+++ b/nodejs/node_modules/express/node_modules/connect/lib/utils.js
@@ -0,0 +1,451 @@
+
+/*!
+ * Connect - utils
+ * Copyright(c) 2010 Sencha Inc.
+ * Copyright(c) 2011 TJ Holowaychuk
+ * MIT Licensed
+ */
+
+/**
+ * Module dependencies.
+ */
+
+var crypto = require('crypto')
+ , Path = require('path')
+ , fs = require('fs');
+
+/**
+ * Flatten the given `arr`.
+ *
+ * @param {Array} arr
+ * @return {Array}
+ * @api private
+ */
+
+exports.flatten = function(arr, ret){
+ var ret = ret || []
+ , len = arr.length;
+ for (var i = 0; i < len; ++i) {
+ if (Array.isArray(arr[i])) {
+ exports.flatten(arr[i], ret);
+ } else {
+ ret.push(arr[i]);
+ }
+ }
+ return ret;
+};
+
+/**
+ * Return md5 hash of the given string and optional encoding,
+ * defaulting to hex.
+ *
+ * utils.md5('wahoo');
+ * // => "e493298061761236c96b02ea6aa8a2ad"
+ *
+ * @param {String} str
+ * @param {String} encoding
+ * @return {String}
+ * @api public
+ */
+
+exports.md5 = function(str, encoding){
+ return crypto
+ .createHash('md5')
+ .update(str)
+ .digest(encoding || 'hex');
+};
+
+/**
+ * Merge object b with object a.
+ *
+ * var a = { foo: 'bar' }
+ * , b = { bar: 'baz' };
+ *
+ * utils.merge(a, b);
+ * // => { foo: 'bar', bar: 'baz' }
+ *
+ * @param {Object} a
+ * @param {Object} b
+ * @return {Object}
+ * @api public
+ */
+
+exports.merge = function(a, b){
+ if (a && b) {
+ for (var key in b) {
+ a[key] = b[key];
+ }
+ }
+ return a;
+};
+
+/**
+ * Escape the given string of `html`.
+ *
+ * @param {String} html
+ * @return {String}
+ * @api public
+ */
+
+exports.escape = function(html){
+ return String(html)
+ .replace(/&(?!\w+;)/g, '&')
+ .replace(//g, '>')
+ .replace(/"/g, '"');
+};
+
+
+/**
+ * Return a unique identifier with the given `len`.
+ *
+ * utils.uid(10);
+ * // => "FDaS435D2z"
+ *
+ * @param {Number} len
+ * @return {String}
+ * @api public
+ */
+
+exports.uid = function(len) {
+ var buf = []
+ , chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
+ , charlen = chars.length;
+
+ for (var i = 0; i < len; ++i) {
+ buf.push(chars[getRandomInt(0, charlen - 1)]);
+ }
+
+ return buf.join('');
+};
+
+/**
+ * Parse the given cookie string into an object.
+ *
+ * @param {String} str
+ * @return {Object}
+ * @api public
+ */
+
+exports.parseCookie = function(str){
+ var obj = {}
+ , pairs = str.split(/[;,] */);
+ for (var i = 0, len = pairs.length; i < len; ++i) {
+ var pair = pairs[i]
+ , eqlIndex = pair.indexOf('=')
+ , key = pair.substr(0, eqlIndex).trim().toLowerCase()
+ , val = pair.substr(++eqlIndex, pair.length).trim();
+
+ // quoted values
+ if ('"' == val[0]) val = val.slice(1, -1);
+
+ // only assign once
+ if (undefined == obj[key]) {
+ val = val.replace(/\+/g, ' ');
+ try {
+ obj[key] = decodeURIComponent(val);
+ } catch (err) {
+ if (err instanceof URIError) {
+ obj[key] = val;
+ } else {
+ throw err;
+ }
+ }
+ }
+ }
+ return obj;
+};
+
+/**
+ * Serialize the given object into a cookie string.
+ *
+ * utils.serializeCookie('name', 'tj', { httpOnly: true })
+ * // => "name=tj; httpOnly"
+ *
+ * @param {String} name
+ * @param {String} val
+ * @param {Object} obj
+ * @return {String}
+ * @api public
+ */
+
+exports.serializeCookie = function(name, val, obj){
+ var pairs = [name + '=' + encodeURIComponent(val)]
+ , obj = obj || {};
+
+ if (obj.domain) pairs.push('domain=' + obj.domain);
+ if (obj.path) pairs.push('path=' + obj.path);
+ if (obj.expires) pairs.push('expires=' + obj.expires.toUTCString());
+ if (obj.httpOnly) pairs.push('httpOnly');
+ if (obj.secure) pairs.push('secure');
+
+ return pairs.join('; ');
+};
+
+/**
+ * Pause `data` and `end` events on the given `obj`.
+ * Middleware performing async tasks _should_ utilize
+ * this utility (or similar), to re-emit data once
+ * the async operation has completed, otherwise these
+ * events may be lost.
+ *
+ * var pause = utils.pause(req);
+ * fs.readFile(path, function(){
+ * next();
+ * pause.resume();
+ * });
+ *
+ * @param {Object} obj
+ * @return {Object}
+ * @api public
+ */
+
+exports.pause = function(obj){
+ var onData
+ , onEnd
+ , events = [];
+
+ // buffer data
+ obj.on('data', onData = function(data, encoding){
+ events.push(['data', data, encoding]);
+ });
+
+ // buffer end
+ obj.on('end', onEnd = function(data, encoding){
+ events.push(['end', data, encoding]);
+ });
+
+ return {
+ end: function(){
+ obj.removeListener('data', onData);
+ obj.removeListener('end', onEnd);
+ },
+ resume: function(){
+ this.end();
+ for (var i = 0, len = events.length; i < len; ++i) {
+ obj.emit.apply(obj, events[i]);
+ }
+ }
+ };
+};
+
+/**
+ * Check `req` and `res` to see if it has been modified.
+ *
+ * @param {IncomingMessage} req
+ * @param {ServerResponse} res
+ * @return {Boolean}
+ * @api public
+ */
+
+exports.modified = function(req, res, headers) {
+ var headers = headers || res._headers || {}
+ , modifiedSince = req.headers['if-modified-since']
+ , lastModified = headers['last-modified']
+ , noneMatch = req.headers['if-none-match']
+ , etag = headers['etag'];
+
+ if (noneMatch) noneMatch = noneMatch.split(/ *, */);
+
+ // check If-None-Match
+ if (noneMatch && etag && ~noneMatch.indexOf(etag)) {
+ return false;
+ }
+
+ // check If-Modified-Since
+ if (modifiedSince && lastModified) {
+ modifiedSince = new Date(modifiedSince);
+ lastModified = new Date(lastModified);
+ // Ignore invalid dates
+ if (!isNaN(modifiedSince.getTime())) {
+ if (lastModified <= modifiedSince) return false;
+ }
+ }
+
+ return true;
+};
+
+/**
+ * Strip `Content-*` headers from `res`.
+ *
+ * @param {ServerResponse} res
+ * @api public
+ */
+
+exports.removeContentHeaders = function(res){
+ Object.keys(res._headers).forEach(function(field){
+ if (0 == field.indexOf('content')) {
+ res.removeHeader(field);
+ }
+ });
+};
+
+/**
+ * Check if `req` is a conditional GET request.
+ *
+ * @param {IncomingMessage} req
+ * @return {Boolean}
+ * @api public
+ */
+
+exports.conditionalGET = function(req) {
+ return req.headers['if-modified-since']
+ || req.headers['if-none-match'];
+};
+
+/**
+ * Respond with 403 "Forbidden".
+ *
+ * @param {ServerResponse} res
+ * @api public
+ */
+
+exports.forbidden = function(res) {
+ var body = 'Forbidden';
+ res.setHeader('Content-Type', 'text/plain');
+ res.setHeader('Content-Length', body.length);
+ res.statusCode = 403;
+ res.end(body);
+};
+
+/**
+ * Respond with 401 "Unauthorized".
+ *
+ * @param {ServerResponse} res
+ * @param {String} realm
+ * @api public
+ */
+
+exports.unauthorized = function(res, realm) {
+ res.statusCode = 401;
+ res.setHeader('WWW-Authenticate', 'Basic realm="' + realm + '"');
+ res.end('Unauthorized');
+};
+
+/**
+ * Respond with 400 "Bad Request".
+ *
+ * @param {ServerResponse} res
+ * @api public
+ */
+
+exports.badRequest = function(res) {
+ res.statusCode = 400;
+ res.end('Bad Request');
+};
+
+/**
+ * Respond with 304 "Not Modified".
+ *
+ * @param {ServerResponse} res
+ * @param {Object} headers
+ * @api public
+ */
+
+exports.notModified = function(res) {
+ exports.removeContentHeaders(res);
+ res.statusCode = 304;
+ res.end();
+};
+
+/**
+ * Return an ETag in the form of `"{title}
+500 {error}
+- {stack}
+ +## Features + + - Faster, smaller, and perhaps easier to use than JavaScript versions of Java's BigDecimal + - 8 KB minified and gzipped + - Simple API but full-featured + - Works with numbers with or without fraction digits in bases from 2 to 64 inclusive + - Replicates the `toExponential`, `toFixed`, `toPrecision` and `toString` methods of JavaScript's Number type + - Includes a `toFraction` and a correctly-rounded `squareRoot` method + - Supports cryptographically-secure pseudo-random number generation + - No dependencies + - Wide platform compatibility: uses JavaScript 1.5 (ECMAScript 3) features only + - Comprehensive [documentation](http://mikemcl.github.io/bignumber.js/) and test set + + + +If a smaller and simpler library is required see [big.js](https://github.com/MikeMcl/big.js/). +It's less than half the size but only works with decimal numbers and only has half the methods. +It also does not allow `NaN` or `Infinity`, or have the configuration options of this library. + +See also [decimal.js](https://github.com/MikeMcl/decimal.js/), which among other things adds support for non-integer powers, and performs all operations to a specified number of significant digits. + +## Load + +The library is the single JavaScript file *bignumber.js* (or minified, *bignumber.min.js*). + +```html + +``` + +For [Node.js](http://nodejs.org) or [io.js](https://iojs.org/en/index.html), the library is available from the [npm](https://npmjs.org/) registry + + $ npm install bignumber.js + +```javascript +var BigNumber = require('bignumber.js'); +``` + +To load with AMD loader libraries such as [requireJS](http://requirejs.org/): + +```javascript +require(['path/to/bignumber'], function(BigNumber) { + // Use BigNumber here in local scope. No global BigNumber. +}); +``` + +## Use + +*In all examples below, `var`, semicolons and `toString` calls are not shown. +If a commented-out value is in quotes it means `toString` has been called on the preceding expression.* + +The library exports a single function: `BigNumber`, the constructor of BigNumber instances. + +It accepts a value of type number *(up to 15 significant digits only)*, string or BigNumber object, + +```javascript +x = new BigNumber(123.4567) +y = BigNumber('123456.7e-3') +z = new BigNumber(x) +x.equals(y) && y.equals(z) && x.equals(z) // true +``` + + +and a base from 2 to 64 inclusive can be specified. + +```javascript +x = new BigNumber(1011, 2) // "11" +y = new BigNumber('zz.9', 36) // "1295.25" +z = x.plus(y) // "1306.25" +``` + +A BigNumber is immutable in the sense that it is not changed by its methods. + +```javascript +0.3 - 0.1 // 0.19999999999999998 +x = new BigNumber(0.3) +x.minus(0.1) // "0.2" +x // "0.3" +``` + +The methods that return a BigNumber can be chained. + +```javascript +x.dividedBy(y).plus(z).times(9).floor() +x.times('1.23456780123456789e+9').plus(9876.5432321).dividedBy('4444562598.111772').ceil() +``` + +Many method names have a shorter alias. + +```javascript +x.squareRoot().dividedBy(y).toPower(3).equals(x.sqrt().div(y).pow(3)) // true +x.cmp(y.mod(z).neg()) == 1 && x.comparedTo(y.modulo(z).negated()) == 1 // true +``` + +Like JavaScript's number type, there are `toExponential`, `toFixed` and `toPrecision` methods + +```javascript +x = new BigNumber(255.5) +x.toExponential(5) // "2.55500e+2" +x.toFixed(5) // "255.50000" +x.toPrecision(5) // "255.50" +x.toNumber() // 255.5 +``` + + and a base can be specified for `toString`. + + ```javascript + x.toString(16) // "ff.8" + ``` + +There is also a `toFormat` method which may be useful for internationalisation + +```javascript +y = new BigNumber('1234567.898765') +y.toFormat(2) // "1,234,567.90" +``` + +The maximum number of decimal places of the result of an operation involving division (i.e. a division, square root, base conversion or negative power operation) is set using the `config` method of the `BigNumber` constructor. + +The other arithmetic operations always give the exact result. + +```javascript +BigNumber.config({ DECIMAL_PLACES: 10, ROUNDING_MODE: 4 }) +// Alternatively, BigNumber.config( 10, 4 ); + +x = new BigNumber(2); +y = new BigNumber(3); +z = x.div(y) // "0.6666666667" +z.sqrt() // "0.8164965809" +z.pow(-3) // "3.3749999995" +z.toString(2) // "0.1010101011" +z.times(z) // "0.44444444448888888889" +z.times(z).round(10) // "0.4444444445" +``` + +There is a `toFraction` method with an optional *maximum denominator* argument + +```javascript +y = new BigNumber(355) +pi = y.dividedBy(113) // "3.1415929204" +pi.toFraction() // [ "7853982301", "2500000000" ] +pi.toFraction(1000) // [ "355", "113" ] +``` + +and `isNaN` and `isFinite` methods, as `NaN` and `Infinity` are valid `BigNumber` values. + +```javascript +x = new BigNumber(NaN) // "NaN" +y = new BigNumber(Infinity) // "Infinity" +x.isNaN() && !y.isNaN() && !x.isFinite() && !y.isFinite() // true +``` + +The value of a BigNumber is stored in a decimal floating point format in terms of a coefficient, exponent and sign. + + +```javascript +x = new BigNumber(-123.456); +x.c // [ 123, 45600000000000 ] coefficient (i.e. significand) +x.e // 2 exponent +x.s // -1 sign +``` + + +Multiple BigNumber constructors can be created, each with their own independent configuration which applies to all BigNumber's created from it. + +```javascript +// Set DECIMAL_PLACES for the original BigNumber constructor +BigNumber.config({ DECIMAL_PLACES: 10 }) + +// Create another BigNumber constructor, optionally passing in a configuration object +BN = BigNumber.another({ DECIMAL_PLACES: 5 }) + +x = new BigNumber(1) +y = new BN(1) + +x.div(3) // '0.3333333333' +y.div(3) // '0.33333' +``` + +For futher information see the [API](http://mikemcl.github.io/bignumber.js/) reference in the *doc* directory. + +## Test + +The *test* directory contains the test scripts for each method. + +The tests can be run with Node or a browser. For Node use + + $ npm test + +or + + $ node test/every-test + +To test a single method, e.g. + + $ node test/toFraction + +For the browser, see *every-test.html* and *single-test.html* in the *test/browser* directory. + +*bignumber-vs-number.html* enables some of the methods of bignumber.js to be compared with those of JavaScript's number type. + +## Versions + +This is version 2.x.x of the library, for version 1.x.x see the tagged releases or switch to the 'original' branch. The advantages of version 2 are that it is considerably faster for numbers with many digits and that there are a some added methods (see Change Log below). The disadvantages are more lines of code and increased code complexity, and the loss of simplicity in no longer having the coefficient of a BigNumber stored in base 10. The 'original' version will continue to be supported. + +## Performance + +See the [README](https://github.com/MikeMcl/bignumber.js/tree/master/perf) in the *perf* directory. + +## Build + +For Node, if [uglify-js](https://github.com/mishoo/UglifyJS2) is installed + + npm install uglify-js -g + +then + + npm run build + +will create *bignumber.min.js*. + +A source map will also be created in the root directory. + +## Feedback + +Open an issue, or email + +Michael + +M8ch88l@gmail.com + +## Licence + +MIT. + +See [LICENCE](https://github.com/MikeMcl/bignumber.js/blob/master/LICENCE). + +## Change Log + +####2.1.2 +* 10/12/2015 +* Bugfix: `window.crypto` not assigned to `crypto`. + +####2.1.1 +* 09/12/2015 +* Prevent code bundler from adding `crypto` shim. + +####2.1.0 +* 26/10/2015 +* For `valueOf` and `toJSON`, include the minus sign with negative zero. + +####2.0.8 +* 2/10/2015 +* Internal round function bugfix. + +####2.0.6 +* 31/03/2015 +* Add bower.json. Tweak division after in-depth review. + +####2.0.5 +* 25/03/2015 +* Amend README. Remove bitcoin address. + +####2.0.4 +* 25/03/2015 +* Critical bugfix #58: division. + +####2.0.3 +* 18/02/2015 +* Amend README. Add source map. + +####2.0.2 +* 18/02/2015 +* Correct links. + +####2.0.1 +* 18/02/2015 +* Add `max`, `min`, `precision`, `random`, `shift`, `toDigits` and `truncated` methods. +* Add the short-forms: `add`, `mul`, `sd`, `sub` and `trunc`. +* Add an `another` method to enable multiple independent constructors to be created. +* Add support for the base 2, 8 and 16 prefixes `0b`, `0o` and `0x`. +* Enable a rounding mode to be specified as a second parameter to `toExponential`, `toFixed`, `toFormat` and `toPrecision`. +* Add a `CRYPTO` configuration property so cryptographically-secure pseudo-random number generation can be specified. +* Add a `MODULO_MODE` configuration property to enable the rounding mode used by the `modulo` operation to be specified. +* Add a `POW_PRECISION` configuration property to enable the number of significant digits calculated by the power operation to be limited. +* Improve code quality. +* Improve documentation. + +####2.0.0 +* 29/12/2014 +* Add `dividedToIntegerBy`, `isInteger` and `toFormat` methods. +* Remove the following short-forms: `isF`, `isZ`, `toE`, `toF`, `toFr`, `toN`, `toP`, `toS`. +* Store a BigNumber's coefficient in base 1e14, rather than base 10. +* Add fast path for integers to BigNumber constructor. +* Incorporate the library into the online documentation. + +####1.5.0 +* 13/11/2014 +* Add `toJSON` and `decimalPlaces` methods. + +####1.4.1 +* 08/06/2014 +* Amend README. + +####1.4.0 +* 08/05/2014 +* Add `toNumber`. + +####1.3.0 +* 08/11/2013 +* Ensure correct rounding of `sqrt` in all, rather than almost all, cases. +* Maximum radix to 64. + +####1.2.1 +* 17/10/2013 +* Sign of zero when x < 0 and x + (-x) = 0. + +####1.2.0 +* 19/9/2013 +* Throw Error objects for stack. + +####1.1.1 +* 22/8/2013 +* Show original value in constructor error message. + +####1.1.0 +* 1/8/2013 +* Allow numbers with trailing radix point. + +####1.0.1 +* Bugfix: error messages with incorrect method name + +####1.0.0 +* 8/11/2012 +* Initial release diff --git a/nodejs/node_modules/mysql/node_modules/bignumber.js/bignumber.js b/nodejs/node_modules/mysql/node_modules/bignumber.js/bignumber.js new file mode 100644 index 0000000..10c4ccc --- /dev/null +++ b/nodejs/node_modules/mysql/node_modules/bignumber.js/bignumber.js @@ -0,0 +1,2694 @@ +/*! bignumber.js v2.1.2 https://github.com/MikeMcl/bignumber.js/LICENCE */ + +;(function (global) { + 'use strict'; + + /* + bignumber.js v2.1.2 + A JavaScript library for arbitrary-precision arithmetic. + https://github.com/MikeMcl/bignumber.js + Copyright (c) 2015 Michael Mclaughlin
+
+
+ BigNumber
+
+
+ another
+ config
+
+
+ max
+
+ min
+
+ random
+
+
+ absoluteValue
+ ceil
+ comparedTo
+
+
+ decimalPlaces
+ dividedBy
+
+ dividedToIntegerBy
+ equals
+ floor
+ greaterThan
+
+ greaterThanOrEqualTo
+ isFinite
+ isInteger
+ isNaN
+ isNegative
+ isZero
+ lessThan
+
+ lessThanOrEqualTo
+
+ minus
+ modulo
+ negated
+ plus
+ precision
+ round
+ shift
+ squareRoot
+ times
+
+ toDigits
+
+ toExponential
+
+ toFixed
+
+ toFormat
+
+ toFraction
+ toJSON
+ toNumber
+ toPower
+
+ toPrecision
+ toString
+ truncated
+ valueOf
+
+
+
+
+
+
+
+
+
+
diff --git a/nodejs/node_modules/mysql/node_modules/bignumber.js/package.json b/nodejs/node_modules/mysql/node_modules/bignumber.js/package.json
new file mode 100644
index 0000000..d5dd897
--- /dev/null
+++ b/nodejs/node_modules/mysql/node_modules/bignumber.js/package.json
@@ -0,0 +1,43 @@
+{
+ "name": "bignumber.js",
+ "description": "A library for arbitrary-precision decimal and non-decimal arithmetic",
+ "version": "2.1.2",
+ "keywords": [
+ "arbitrary",
+ "precision",
+ "arithmetic",
+ "big",
+ "number",
+ "decimal",
+ "float",
+ "biginteger",
+ "bigdecimal",
+ "bignumber",
+ "bigint",
+ "bignum"
+ ],
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/MikeMcl/bignumber.js.git"
+ },
+ "main": "bignumber",
+ "author": {
+ "name": "Michael Mclaughlin",
+ "email": "M8ch88l@gmail.com"
+ },
+ "engines": {
+ "node": "*"
+ },
+ "license": "MIT",
+ "scripts": {
+ "test": "node ./test/every-test.js",
+ "build": "uglifyjs bignumber.js --source-map bignumber.js.map -c -m -o bignumber.min.js --preamble \"/* bignumber.js v2.1.2 https://github.com/MikeMcl/bignumber.js/LICENCE */\""
+ },
+ "readme": "\r\n\r\nA JavaScript library for arbitrary-precision decimal and non-decimal arithmetic.\r\n\r\n[](https://travis-ci.org/MikeMcl/bignumber.js)\r\n\r\nbignumber.js
+ +A JavaScript library for arbitrary-precision arithmetic.
+ + +API
+ ++ See the README on GitHub for a + quick-start introduction. +
+
+ In all examples below, var and semicolons are not shown, and if a commented-out
+ value is in quotes it means toString has been called on the preceding expression.
+
CONSTRUCTOR
+ +
+ BigNumberBigNumber(value [, base]) ⇒ BigNumber
+
+ -
+
value
+ - + number|string|BigNumber: see RANGE for + range. + +
- + A numeric value. + +
-
+ Legitimate values include ±
0, ±Infinityand +NaN. +
+ -
+ Values of type number with more than
15significant digits are + considered invalid (ifERRORSis true) as calling +toStringorvalueOfon + such numbers may not result in the intended value. +console.log( 823456789123456.3 ); // 823456789123456.2
+
+ - + There is no limit to the number of digits of a value of type string (other than + that of JavaScript's maximum array size). + +
- + Decimal string values may be in exponential, as well as normal (fixed-point) notation. + Non-decimal values must be in normal notation. + +
-
+ String values in hexadecimal literal form, e.g.
'0xff', are valid, as are + string values with the octal and binary prefixs'0o'and'0b'. + String values in octal literal form without the prefix will be interpreted as + decimals, e.g.'011'is interpreted as 11, not 9. +
+ - Values in any base may have fraction digits. +
-
+ For bases from
10to36, lower and/or upper case letters can be + used to represent values from10to35. +
+ -
+ For bases above 36,
a-zrepresents values from10to +35,A-Zfrom36to61, and +$and_represent62and63respectively + (this can be changed by editing theALPHABETvariable near the top of the + source file). +
+
-
+
base
+ -
+ number: integer,
2to64inclusive +
+ - The base of
value.
+ -
+ If
baseis omitted, or isnullorundefined, base +10is assumed. +
+
+
Returns a new instance of a BigNumber object.
+
+ If a base is specified, the value is rounded according to
+ the current DECIMAL_PLACES and
+ ROUNDING_MODE configuration.
+
+ See Errors for the treatment of an invalid value or
+ base.
+
+x = new BigNumber(9) // '9'
+y = new BigNumber(x) // '9'
+
+// 'new' is optional if ERRORS is false
+BigNumber(435.345) // '435.345'
+
+new BigNumber('5032485723458348569331745.33434346346912144534543')
+new BigNumber('4.321e+4') // '43210'
+new BigNumber('-735.0918e-430') // '-7.350918e-428'
+new BigNumber(Infinity) // 'Infinity'
+new BigNumber(NaN) // 'NaN'
+new BigNumber('.5') // '0.5'
+new BigNumber('+2') // '2'
+new BigNumber(-10110100.1, 2) // '-180.5'
+new BigNumber(-0b10110100.1) // '-180.5'
+new BigNumber('123412421.234324', 5) // '607236.557696'
+new BigNumber('ff.8', 16) // '255.5'
+new BigNumber('0xff.8') // '255.5'
+
+ The following throws 'not a base 2 number' if
+ ERRORS is true, otherwise it returns a BigNumber with value
+ NaN.
+
new BigNumber(9, 2)+
+ The following throws 'number type has more than 15 significant digits' if
+ errors is true, otherwise it returns a BigNumber with value
+ 96517860459076820.
+
new BigNumber(96517860459076817.4395)+
+ The following throws 'not a number' if ERRORS
+ is true, otherwise it returns a BigNumber with value NaN.
+
new BigNumber('blurgh')
+ + A value is only rounded by the constructor if a base is specified. +
+BigNumber.config({ DECIMAL_PLACES: 5 })
+new BigNumber(1.23456789) // '1.23456789'
+new BigNumber(1.23456789, 10) // '1.23457'
+
+
+
+ Methods
+The static methods of a BigNumber constructor.
+ + + + +
+ another.another([obj]) ⇒ BigNumber constructor
+
+ obj: object
+ Returns a new independent BigNumber constructor with configuration as described by
+ obj (see config), or with the default
+ configuration if obj is null or undefined.
+
BigNumber.config({ DECIMAL_PLACES: 5 })
+BN = BigNumber.another({ DECIMAL_PLACES: 9 })
+
+x = new BigNumber(1)
+y = new BN(1)
+
+x.div(3) // 0.33333
+y.div(3) // 0.333333333
+
+// BN = BigNumber.another({ DECIMAL_PLACES: 9 }) is equivalent to:
+BN = BigNumber.another()
+BN.config({ DECIMAL_PLACES: 9 })
+
+
+
+ configconfig([obj]) ⇒ object
+
+ obj: object: an object that contains some or all of the following
+ properties.
+
Configures the 'global' settings for this particular BigNumber constructor.
+Note: the configuration can also be supplied as an argument list, see below.
+-
+
DECIMAL_PLACES
+ -
+ number: integer,
0to1e+9inclusive
+ Default value:20+
+ -
+ The maximum number of decimal places of the results of operations involving
+ division, i.e. division, square root and base conversion operations, and power
+ operations with negative exponents.
+
+ -
+
BigNumber.config({ DECIMAL_PLACES: 5 }) +BigNumber.config(5) // equivalent+
+
+
+
+ ROUNDING_MODE
+ -
+ number: integer,
0to8inclusive
+ Default value:4(ROUND_HALF_UP) +
+ -
+ The rounding mode used in the above operations and the default rounding mode of
+
round, +toExponential, +toFixed, +toFormatand +toPrecision. +
+ - The modes are available as enumerated properties of the BigNumber constructor. +
-
+
BigNumber.config({ ROUNDING_MODE: 0 }) +BigNumber.config(null, BigNumber.ROUND_UP) // equivalent+
+
+
+
+ EXPONENTIAL_AT
+ -
+ number: integer, magnitude
0to1e+9inclusive, or +
+ number[]: [ integer-1e+9to0inclusive, integer +0to1e+9inclusive ]
+ Default value:[-7, 20]+
+ -
+ The exponent value(s) at which
toStringreturns exponential notation. +
+ -
+ If a single number is assigned, the value is the exponent magnitude.
+ If an array of two numbers is assigned then the first number is the negative exponent + value at and beneath which exponential notation is used, and the second number is the + positive exponent value at and above which the same. +
+ -
+ For example, to emulate JavaScript numbers in terms of the exponent values at which they
+ begin to use exponential notation, use
[-7, 20]. +
+ -
+
BigNumber.config({ EXPONENTIAL_AT: 2 }) +new BigNumber(12.3) // '12.3' e is only 1 +new BigNumber(123) // '1.23e+2' +new BigNumber(0.123) // '0.123' e is only -1 +new BigNumber(0.0123) // '1.23e-2' + +BigNumber.config({ EXPONENTIAL_AT: [-7, 20] }) +new BigNumber(123456789) // '123456789' e is only 8 +new BigNumber(0.000000123) // '1.23e-7' + +// Almost never return exponential notation: +BigNumber.config({ EXPONENTIAL_AT: 1e+9 }) + +// Always return exponential notation: +BigNumber.config({ EXPONENTIAL_AT: 0 })+
+ -
+ Regardless of the value of
EXPONENTIAL_AT, thetoFixedmethod + will always return a value in normal notation and thetoExponentialmethod + will always return a value in exponential form. +
+ -
+ Calling
toStringwith a base argument, e.g.toString(10), will + also always return normal notation. +
+
+
+
+ RANGE
+ -
+ number: integer, magnitude
1to1e+9inclusive, or +
+ number[]: [ integer-1e+9to-1inclusive, integer +1to1e+9inclusive ]
+ Default value:[-1e+9, 1e+9]+
+ -
+ The exponent value(s) beyond which overflow to
Infinityand underflow to + zero occurs. +
+ -
+ If a single number is assigned, it is the maximum exponent magnitude: values wth a
+ positive exponent of greater magnitude become
Infinityand those with a + negative exponent of greater magnitude become zero. +- + If an array of two numbers is assigned then the first number is the negative exponent + limit and the second number is the positive exponent limit. +
+- + For example, to emulate JavaScript numbers in terms of the exponent values at which they + become zero and
+Infinity, use[-324, 308]. +- +
+BigNumber.config({ RANGE: 500 }) +BigNumber.config().RANGE // [ -500, 500 ] +new BigNumber('9.999e499') // '9.999e+499' +new BigNumber('1e500') // 'Infinity' +new BigNumber('1e-499') // '1e-499' +new BigNumber('1e-500') // '0' + +BigNumber.config({ RANGE: [-3, 4] }) +new BigNumber(99999) // '99999' e is only 4 +new BigNumber(100000) // 'Infinity' e is 5 +new BigNumber(0.001) // '0.01' e is only -3 +new BigNumber(0.0001) // '0' e is -4+- + The largest possible magnitude of a finite BigNumber is +
+ + + +9.999...e+1000000000.
+ The smallest possible magnitude of a non-zero BigNumber is1e-1000000000. + ERRORS
+ -
+ boolean|number:
true,false,0or +1.
+ Default value:true+
+ -
+ The value that determines whether BigNumber Errors are thrown.
+ IfERRORSis false, no errors will be thrown. +
+ - See Errors. +
BigNumber.config({ ERRORS: false })
+
+
+
+ CRYPTO
+ -
+ boolean|number:
true,false,0or +1.
+ Default value:false+
+ - + The value that determines whether cryptographically-secure pseudo-random number + generation is used. + +
-
+ If
CRYPTOis set totruethen the +randommethod will generate random digits using +crypto.getRandomValuesin browsers that support it, or +crypto.randomBytesif using a version of Node.js that supports it. +
+ -
+ If neither function is supported by the host environment then attempting to set
+
CRYPTOtotruewill fail, and ifERRORS+ istruean exception will be thrown. +
+ -
+ If
CRYPTOisfalsethen the source of randomness used will be +Math.random(which is assumed to generate at least30bits of + randomness). +
+ - See
random.
+ -
+
BigNumber.config({ CRYPTO: true }) +BigNumber.config().CRYPTO // true +BigNumber.random() // 0.54340758610486147524+
+
+
+
+ MODULO_MODE
+ -
+ number: integer,
0to9inclusive
+ Default value:1(ROUND_DOWN) +
+ - The modulo mode used when calculating the modulus:
a mod n.
+ -
+ The quotient,
q = a / n, is calculated according to the +ROUNDING_MODEthat corresponds to the chosen +MODULO_MODE. +
+ - The remainder,
r, is calculated as:r = a - n * q.
+ - + The modes that are most commonly used for the modulus/remainder operation are shown in + the following table. Although the other rounding modes can be used, they may not give + useful results. + +
-
+
+
+Property Value Description + +ROUND_UP 0 ++ The remainder is positive if the dividend is negative, otherwise it is negative. + ++ +ROUND_DOWN 1 ++ The remainder has the same sign as the dividend. +
+ This uses 'truncating division' and matches the behaviour of JavaScript's + remainder operator%. ++ +ROUND_FLOOR 3 ++ The remainder has the same sign as the divisor. +
+ This matches Python's%operator. ++ +ROUND_HALF_EVEN 6 +The IEEE 754 remainder function. ++ +EUCLID 9 ++ The remainder is always positive. Euclidian division: +
+q = sign(n) * floor(a / abs(n))+
+ - + The rounding/modulo modes are available as enumerated properties of the BigNumber + constructor. + +
- See
modulo.
+ -
+
BigNumber.config({ MODULO_MODE: BigNumber.EUCLID }) +BigNumber.config({ MODULO_MODE: 9 }) // equivalent+
+
+
+
+ POW_PRECISION
+ -
+ number: integer,
0to1e+9inclusive.
+ Default value:100+
+ - + The maximum number of significant digits of the result of the power operation. + +
- If set to
0, the number of signifcant digits will not be limited.
+ - See
toPower.
+ BigNumber.config({ POW_PRECISION: 100 })
+
+
+
+ FORMAT
+ - object +
-
+ The
FORMATobject configures the format of the string returned by the +toFormatmethod. +
+ -
+ The example below shows the properties of the
FORMATobject that are + recognised, and their default values. +
+ -
+ Unlike the other configuration properties, the values of the properties of the
+
FORMATobject will not be checked for validity. The existing +FORMATobject will simply be replaced by the object that is passed in. + Note that all the properties shown below do not have to be included. +
+ - See
toFormatfor examples of usage.
+ -
+
+BigNumber.config({ + FORMAT: { + // the decimal separator + decimalSeparator: '.', + // the grouping separator of the integer part + groupSeparator: ',', + // the primary grouping size of the integer part + groupSize: 3, + // the secondary grouping size of the integer part + secondaryGroupSize: 0, + // the grouping separator of the fraction part + fractionGroupSeparator: ' ', + // the grouping size of the fraction part + fractionGroupSize: 0 + } +});+
+
+
Returns an object with the above properties and their current values.
+
+ If the value to be assigned to any of the above properties is null or
+ undefined it is ignored.
+
See Errors for the treatment of invalid values.
+
+BigNumber.config({
+ DECIMAL_PLACES: 40,
+ ROUNDING_MODE: BigNumber.ROUND_HALF_CEIL,
+ EXPONENTIAL_AT: [-10, 20],
+ RANGE: [-500, 500],
+ ERRORS: true,
+ CRYPTO: true,
+ MODULO_MODE: BigNumber.ROUND_FLOOR,
+ POW_PRECISION: 80,
+ FORMAT: {
+ groupSize: 3,
+ groupSeparator: ' ',
+ decimalSeparator: ','
+ }
+});
+
+// Alternatively but equivalently (excluding FORMAT):
+BigNumber.config( 40, 7, [-10, 20], 500, 1, 1, 3, 80 )
+
+obj = BigNumber.config();
+obj.ERRORS // true
+obj.RANGE // [-500, 500]
+
+
+
+
+ max.max([arg1 [, arg2, ...]]) ⇒ BigNumber
+
+
+ arg1, arg2, ...: number|string|BigNumber
+ See BigNumber for further parameter details.
+
+ Returns a BigNumber whose value is the maximum of arg1,
+ arg2,... .
+
The argument to this method can also be an array of values.
+The return value is always exact and unrounded.
+x = new BigNumber('3257869345.0378653')
+BigNumber.max(4e9, x, '123456789.9') // '4000000000'
+
+arr = [12, '13', new BigNumber(14)]
+BigNumber.max(arr) // '14'
+
+
+
+
+ min.min([arg1 [, arg2, ...]]) ⇒ BigNumber
+
+
+ arg1, arg2, ...: number|string|BigNumber
+ See BigNumber for further parameter details.
+
+ Returns a BigNumber whose value is the minimum of arg1,
+ arg2,... .
+
The argument to this method can also be an array of values.
+The return value is always exact and unrounded.
+x = new BigNumber('3257869345.0378653')
+BigNumber.min(4e9, x, '123456789.9') // '123456789.9'
+
+arr = [2, new BigNumber(-14), '-15.9999', -12]
+BigNumber.min(arr) // '-15.9999'
+
+
+
+
+ random.random([dp]) ⇒ BigNumber
+
+ dp: number: integer, 0 to 1e+9 inclusive
+ Returns a new BigNumber with a pseudo-random value equal to or greater than 0 and
+ less than 1.
+
+ The return value will have dp decimal places (or less if trailing zeros are
+ produced).
+ If dp is omitted then the number of decimal places will default to the current
+ DECIMAL_PLACES setting.
+
+ Depending on the value of this BigNumber constructor's
+ CRYPTO setting and the support for the
+ crypto object in the host environment, the random digits of the return value are
+ generated by either Math.random (fastest), crypto.getRandomValues
+ (Web Cryptography API in recent browsers) or crypto.randomBytes (Node.js).
+
+ If CRYPTO is true, i.e. one of the
+ crypto methods is to be used, the value of a returned BigNumber should be
+ cryptographically-secure and statistically indistinguishable from a random value.
+
BigNumber.config({ DECIMAL_PLACES: 10 })
+BigNumber.random() // '0.4117936847'
+BigNumber.random(20) // '0.78193327636914089009'
+
+
+
+ Properties
+
+ The library's enumerated rounding modes are stored as properties of the constructor.
+ (They are not referenced internally by the library itself.)
+
+ Rounding modes 0 to 6 (inclusive) are the same as those of Java's
+ BigDecimal class.
+
| Property | +Value | +Description | +
|---|---|---|
| ROUND_UP | +0 | +Rounds away from zero | +
| ROUND_DOWN | +1 | +Rounds towards zero | +
| ROUND_CEIL | +2 | +Rounds towards Infinity |
+
| ROUND_FLOOR | +3 | +Rounds towards -Infinity |
+
| ROUND_HALF_UP | +4 | +
+ Rounds towards nearest neighbour. + If equidistant, rounds away from zero + |
+
| ROUND_HALF_DOWN | +5 | +
+ Rounds towards nearest neighbour. + If equidistant, rounds towards zero + |
+
| ROUND_HALF_EVEN | +6 | +
+ Rounds towards nearest neighbour. + If equidistant, rounds towards even neighbour + |
+
| ROUND_HALF_CEIL | +7 | +
+ Rounds towards nearest neighbour. + If equidistant, rounds towards Infinity
+ |
+
| ROUND_HALF_FLOOR | +8 | +
+ Rounds towards nearest neighbour. + If equidistant, rounds towards -Infinity
+ |
+
+BigNumber.config({ ROUNDING_MODE: BigNumber.ROUND_CEIL })
+BigNumber.config({ ROUNDING_MODE: 2 }) // equivalent
+
+
+ INSTANCE
+ +Methods
+The methods inherited by a BigNumber instance from its constructor's prototype object.
+A BigNumber is immutable in the sense that it is not changed by its methods.
+
+ The treatment of ±0, ±Infinity and NaN is
+ consistent with how JavaScript treats these values.
+
+ Many method names have a shorter alias.
+ (Internally, the library always uses the shorter method names.)
+
absoluteValue.abs() ⇒ BigNumber
+ + Returns a BigNumber whose value is the absolute value, i.e. the magnitude, of the value of + this BigNumber. +
+The return value is always exact and unrounded.
++x = new BigNumber(-0.8) +y = x.absoluteValue() // '0.8' +z = y.abs() // '0.8'+ + + +
ceil.ceil() ⇒ BigNumber
+
+ Returns a BigNumber whose value is the value of this BigNumber rounded to
+ a whole number in the direction of positive Infinity.
+
+x = new BigNumber(1.3) +x.ceil() // '2' +y = new BigNumber(-1.8) +y.ceil() // '-1'+ + + +
comparedTo.cmp(n [, base]) ⇒ number
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
| Returns | |
|---|---|
1 |
+ If the value of this BigNumber is greater than the value of n |
+
-1 |
+ If the value of this BigNumber is less than the value of n |
+
0 |
+ If this BigNumber and n have the same value |
+
null |
+ If the value of either this BigNumber or n is NaN |
+
+x = new BigNumber(Infinity)
+y = new BigNumber(5)
+x.comparedTo(y) // 1
+x.comparedTo(x.minus(1)) // 0
+y.cmp(NaN) // null
+y.cmp('110', 2) // -1
+
+
+
+ decimalPlaces.dp() ⇒ number
+
+ Return the number of decimal places of the value of this BigNumber, or null if
+ the value of this BigNumber is ±Infinity or NaN.
+
+x = new BigNumber(123.45)
+x.decimalPlaces() // 2
+y = new BigNumber('9.9e-101')
+y.dp() // 102
+
+
+
+ dividedBy.div(n [, base]) ⇒ BigNumber
+
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Returns a BigNumber whose value is the value of this BigNumber divided by
+ n, rounded according to the current
+ DECIMAL_PLACES and
+ ROUNDING_MODE configuration.
+
+x = new BigNumber(355) +y = new BigNumber(113) +x.dividedBy(y) // '3.14159292035398230088' +x.div(5) // '71' +x.div(47, 16) // '5'+ + + +
+ dividedToIntegerBy.divToInt(n [, base]) ⇒
+ BigNumber
+
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Return a BigNumber whose value is the integer part of dividing the value of this BigNumber by
+ n.
+
+x = new BigNumber(5)
+y = new BigNumber(3)
+x.dividedToIntegerBy(y) // '1'
+x.divToInt(0.7) // '7'
+x.divToInt('0.f', 16) // '5'
+
+
+
+ equals.eq(n [, base]) ⇒ boolean
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Returns true if the value of this BigNumber equals the value of n,
+ otherwise returns false.
+ As with JavaScript, NaN does not equal NaN.
+
Note: This method uses the comparedTo method internally.
+0 === 1e-324 // true
+x = new BigNumber(0)
+x.equals('1e-324') // false
+BigNumber(-0).eq(x) // true ( -0 === 0 )
+BigNumber(255).eq('ff', 16) // true
+
+y = new BigNumber(NaN)
+y.equals(NaN) // false
+
+
+
+ floor.floor() ⇒ BigNumber
+
+ Returns a BigNumber whose value is the value of this BigNumber rounded to a whole number in
+ the direction of negative Infinity.
+
+x = new BigNumber(1.8) +x.floor() // '1' +y = new BigNumber(-1.3) +y.floor() // '-2'+ + + +
greaterThan.gt(n [, base]) ⇒ boolean
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Returns true if the value of this BigNumber is greater than the value of
+ n, otherwise returns false.
+
Note: This method uses the comparedTo method internally.
+0.1 > (0.3 - 0.2) // true +x = new BigNumber(0.1) +x.greaterThan(BigNumber(0.3).minus(0.2)) // false +BigNumber(0).gt(x) // false +BigNumber(11, 3).gt(11.1, 2) // true+ + + +
+ greaterThanOrEqualTo.gte(n [, base]) ⇒ boolean
+
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Returns true if the value of this BigNumber is greater than or equal to the value
+ of n, otherwise returns false.
+
Note: This method uses the comparedTo method internally.
+(0.3 - 0.2) >= 0.1 // false
+x = new BigNumber(0.3).minus(0.2)
+x.greaterThanOrEqualTo(0.1) // true
+BigNumber(1).gte(x) // true
+BigNumber(10, 18).gte('i', 36) // true
+
+
+
+ isFinite.isFinite() ⇒ boolean
+
+ Returns true if the value of this BigNumber is a finite number, otherwise
+ returns false.
+
+ The only possible non-finite values of a BigNumber are NaN, Infinity
+ and -Infinity.
+
+x = new BigNumber(1) +x.isFinite() // true +y = new BigNumber(Infinity) +y.isFinite() // false+
+ Note: The native method isFinite() can be used if
+ n <= Number.MAX_VALUE.
+
isInteger.isInt() ⇒ boolean
+
+ Returns true if the value of this BigNumber is a whole number, otherwise returns
+ false.
+
+x = new BigNumber(1) +x.isInteger() // true +y = new BigNumber(123.456) +y.isInt() // false+ + + +
isNaN.isNaN() ⇒ boolean
+
+ Returns true if the value of this BigNumber is NaN, otherwise
+ returns false.
+
+x = new BigNumber(NaN)
+x.isNaN() // true
+y = new BigNumber('Infinity')
+y.isNaN() // false
+ Note: The native method isNaN() can also be used.
isNegative.isNeg() ⇒ boolean
+
+ Returns true if the value of this BigNumber is negative, otherwise returns
+ false.
+
+x = new BigNumber(-0) +x.isNegative() // true +y = new BigNumber(2) +y.isNeg() // false+
Note: n < 0 can be used if n <= -Number.MIN_VALUE.
isZero.isZero() ⇒ boolean
+
+ Returns true if the value of this BigNumber is zero or minus zero, otherwise
+ returns false.
+
+x = new BigNumber(-0) +x.isZero() && x.isNeg() // true +y = new BigNumber(Infinity) +y.isZero() // false+
Note: n == 0 can be used if n >= Number.MIN_VALUE.
lessThan.lt(n [, base]) ⇒ boolean
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Returns true if the value of this BigNumber is less than the value of
+ n, otherwise returns false.
+
Note: This method uses the comparedTo method internally.
+(0.3 - 0.2) < 0.1 // true +x = new BigNumber(0.3).minus(0.2) +x.lessThan(0.1) // false +BigNumber(0).lt(x) // true +BigNumber(11.1, 2).lt(11, 3) // true+ + + +
+ lessThanOrEqualTo.lte(n [, base]) ⇒ boolean
+
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Returns true if the value of this BigNumber is less than or equal to the value of
+ n, otherwise returns false.
+
Note: This method uses the comparedTo method internally.
+0.1 <= (0.3 - 0.2) // false
+x = new BigNumber(0.1)
+x.lessThanOrEqualTo(BigNumber(0.3).minus(0.2)) // true
+BigNumber(-1).lte(x) // true
+BigNumber(10, 18).lte('i', 36) // true
+
+
+
+
+ minus.minus(n [, base]) ⇒ BigNumber
+
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
Returns a BigNumber whose value is the value of this BigNumber minus n.
The return value is always exact and unrounded.
++0.3 - 0.1 // 0.19999999999999998 +x = new BigNumber(0.3) +x.minus(0.1) // '0.2' +x.minus(0.6, 20) // '0'+ + + +
modulo.mod(n [, base]) ⇒ BigNumber
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
+ Returns a BigNumber whose value is the value of this BigNumber modulo n, i.e.
+ the integer remainder of dividing this BigNumber by n.
+
+ The value returned, and in particular its sign, is dependent on the value of the
+ MODULO_MODE setting of this BigNumber constructor.
+ If it is 1 (default value), the result will have the same sign as this BigNumber,
+ and it will match that of Javascript's % operator (within the limits of double
+ precision) and BigDecimal's remainder method.
+
The return value is always exact and unrounded.
+
+ See MODULO_MODE for a description of the other
+ modulo modes.
+
+1 % 0.9 // 0.09999999999999998
+x = new BigNumber(1)
+x.modulo(0.9) // '0.1'
+y = new BigNumber(33)
+y.mod('a', 33) // '3'
+
+
+
+ negated.neg() ⇒ BigNumber
+
+ Returns a BigNumber whose value is the value of this BigNumber negated, i.e. multiplied by
+ -1.
+
+x = new BigNumber(1.8) +x.negated() // '-1.8' +y = new BigNumber(-1.3) +y.neg() // '1.3'+ + + +
plus.plus(n [, base]) ⇒ BigNumber
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
Returns a BigNumber whose value is the value of this BigNumber plus n.
The return value is always exact and unrounded.
+
+0.1 + 0.2 // 0.30000000000000004
+x = new BigNumber(0.1)
+y = x.plus(0.2) // '0.3'
+BigNumber(0.7).plus(x).plus(y) // '1'
+x.plus('0.1', 8) // '0.225'
+
+
+
+ precision.sd([z]) ⇒ number
+
+ z: boolean|number: true, false, 0
+ or 1
+
Returns the number of significant digits of the value of this BigNumber.
+
+ If z is true or 1 then any trailing zeros of the
+ integer part of a number are counted as significant digits, otherwise they are not.
+
+x = new BigNumber(1.234) +x.precision() // 4 +y = new BigNumber(987000) +y.sd() // 3 +y.sd(true) // 6+ + + +
round.round([dp [, rm]]) ⇒ BigNumber
+
+ dp: number: integer, 0 to 1e+9 inclusive
+ rm: number: integer, 0 to 8 inclusive
+
+ Returns a BigNumber whose value is the value of this BigNumber rounded by rounding mode
+ rm to a maximum of dp decimal places.
+
+ if dp is omitted, or is null or undefined, the
+ return value is n rounded to a whole number.
+ if rm is omitted, or is null or undefined,
+ ROUNDING_MODE is used.
+
+ See Errors for the treatment of other non-integer or out of range
+ dp or rm values.
+
+x = 1234.56 +Math.round(x) // 1235 + +y = new BigNumber(x) +y.round() // '1235' +y.round(1) // '1234.6' +y.round(2) // '1234.56' +y.round(10) // '1234.56' +y.round(0, 1) // '1234' +y.round(0, 6) // '1235' +y.round(1, 1) // '1234.5' +y.round(1, BigNumber.ROUND_HALF_EVEN) // '1234.6' +y // '1234.56'+ + + +
shift.shift(n) ⇒ BigNumber
+
+ n: number: integer,
+ -9007199254740991 to 9007199254740991 inclusive
+
+ Returns a BigNumber whose value is the value of this BigNumber shifted n places.
+
+ The shift is of the decimal point, i.e. of powers of ten, and is to the left if n
+ is negative or to the right if n is positive.
+
The return value is always exact and unrounded.
++x = new BigNumber(1.23) +x.shift(3) // '1230' +x.shift(-3) // '0.00123'+ + + +
squareRoot.sqrt() ⇒ BigNumber
+
+ Returns a BigNumber whose value is the square root of the value of this BigNumber,
+ rounded according to the current
+ DECIMAL_PLACES and
+ ROUNDING_MODE configuration.
+
+ The return value will be correctly rounded, i.e. rounded as if the result was first calculated + to an infinite number of correct digits before rounding. +
++x = new BigNumber(16) +x.squareRoot() // '4' +y = new BigNumber(3) +y.sqrt() // '1.73205080756887729353'+ + + +
times.times(n [, base]) ⇒ BigNumber
+
+ n: number|string|BigNumber
+ base: number
+ See BigNumber for further parameter details.
+
Returns a BigNumber whose value is the value of this BigNumber times n.
The return value is always exact and unrounded.
+
+0.6 * 3 // 1.7999999999999998
+x = new BigNumber(0.6)
+y = x.times(3) // '1.8'
+BigNumber('7e+500').times(y) // '1.26e+501'
+x.times('-a', 16) // '-6'
+
+
+
+
+ toDigits.toDigits([sd [, rm]]) ⇒ BigNumber
+
+
+ sd: number: integer, 1 to 1e+9 inclusive.
+ rm: number: integer, 0 to 8 inclusive.
+
+ Returns a BigNumber whose value is the value of this BigNumber rounded to sd
+ significant digits using rounding mode rm.
+
+ If sd is omitted or is null or undefined, the return
+ value will not be rounded.
+ If rm is omitted or is null or undefined,
+ ROUNDING_MODE will be used.
+
+ See Errors for the treatment of other non-integer or out of range
+ sd or rm values.
+
+BigNumber.config({ precision: 5, rounding: 4 })
+x = new BigNumber(9876.54321)
+
+x.toSignificantDigits() // '9876.5'
+x.toSignificantDigits(6) // '9876.54'
+x.toSignificantDigits(6, BigNumber.ROUND_UP) // '9876.55'
+x.toSD(2) // '9900'
+x.toSD(2, 1) // '9800'
+x // '9876.54321'
+
+
+
+
+ toExponential.toExponential([dp [, rm]]) ⇒ string
+
+
+ dp: number: integer, 0 to 1e+9 inclusive
+ rm: number: integer, 0 to 8 inclusive
+
+ Returns a string representing the value of this BigNumber in exponential notation rounded
+ using rounding mode rm to dp decimal places, i.e with one digit
+ before the decimal point and dp digits after it.
+
+ If the value of this BigNumber in exponential notation has fewer than dp fraction
+ digits, the return value will be appended with zeros accordingly.
+
+ If dp is omitted, or is null or undefined, the number
+ of digits after the decimal point defaults to the minimum number of digits necessary to
+ represent the value exactly.
+ If rm is omitted or is null or undefined,
+ ROUNDING_MODE is used.
+
+ See Errors for the treatment of other non-integer or out of range
+ dp or rm values.
+
+x = 45.6 +y = new BigNumber(x) +x.toExponential() // '4.56e+1' +y.toExponential() // '4.56e+1' +x.toExponential(0) // '5e+1' +y.toExponential(0) // '5e+1' +x.toExponential(1) // '4.6e+1' +y.toExponential(1) // '4.6e+1' +y.toExponential(1, 1) // '4.5e+1' (ROUND_DOWN) +x.toExponential(3) // '4.560e+1' +y.toExponential(3) // '4.560e+1'+ + + +
+ toFixed.toFixed([dp [, rm]]) ⇒ string
+
+
+ dp: number: integer, 0 to 1e+9 inclusive
+ rm: number: integer, 0 to 8 inclusive
+
+ Returns a string representing the value of this BigNumber in normal (fixed-point) notation
+ rounded to dp decimal places using rounding mode rm.
+
+ If the value of this BigNumber in normal notation has fewer than dp fraction
+ digits, the return value will be appended with zeros accordingly.
+
+ Unlike Number.prototype.toFixed, which returns exponential notation if a number
+ is greater or equal to 1021, this method will always return normal
+ notation.
+
+ If dp is omitted or is null or undefined, the return
+ value will be unrounded and in normal notation. This is also unlike
+ Number.prototype.toFixed, which returns the value to zero decimal places.
+ It is useful when fixed-point notation is required and the current
+ EXPONENTIAL_AT setting causes
+ toString to return exponential notation.
+ If rm is omitted or is null or undefined,
+ ROUNDING_MODE is used.
+
+ See Errors for the treatment of other non-integer or out of range
+ dp or rm values.
+
+x = 3.456 +y = new BigNumber(x) +x.toFixed() // '3' +y.toFixed() // '3.456' +y.toFixed(0) // '3' +x.toFixed(2) // '3.46' +y.toFixed(2) // '3.46' +y.toFixed(2, 1) // '3.45' (ROUND_DOWN) +x.toFixed(5) // '3.45600' +y.toFixed(5) // '3.45600'+ + + +
+ toFormat.toFormat([dp [, rm]]) ⇒ string
+
+
+ dp: number: integer, 0 to 1e+9 inclusive
+ rm: number: integer, 0 to 8 inclusive
+
+
+ Returns a string representing the value of this BigNumber in normal (fixed-point) notation
+ rounded to dp decimal places using rounding mode rm, and formatted
+ according to the properties of the FORMAT object.
+
+ See the examples below for the properties of the
+ FORMAT object, their types and their usage.
+
+ If dp is omitted or is null or undefined, then the
+ return value is not rounded to a fixed number of decimal places.
+ If rm is omitted or is null or undefined,
+ ROUNDING_MODE is used.
+
+ See Errors for the treatment of other non-integer or out of range
+ dp or rm values.
+
+format = {
+ decimalSeparator: '.',
+ groupSeparator: ',',
+ groupSize: 3,
+ secondaryGroupSize: 0,
+ fractionGroupSeparator: ' ',
+ fractionGroupSize: 0
+}
+BigNumber.config({ FORMAT: format })
+
+x = new BigNumber('123456789.123456789')
+x.toFormat() // '123,456,789.123456789'
+x.toFormat(1) // '123,456,789.1'
+
+// If a reference to the object assigned to FORMAT has been retained,
+// the format properties can be changed directly
+format.groupSeparator = ' '
+format.fractionGroupSize = 5
+x.toFormat() // '123 456 789.12345 6789'
+
+BigNumber.config({
+ FORMAT: {
+ decimalSeparator = ',',
+ groupSeparator = '.',
+ groupSize = 3,
+ secondaryGroupSize = 2
+ }
+})
+
+x.toFormat(6) // '12.34.56.789,123'
+
+
+
+
+ toFraction.toFraction([max]) ⇒ [string, string]
+
+
+ max: number|string|BigNumber: integer >= 1 and <
+ Infinity
+
+ Returns a string array representing the value of this BigNumber as a simple fraction with an
+ integer numerator and an integer denominator. The denominator will be a positive non-zero
+ value less than or equal to max.
+
+ If a maximum denominator, max, is not specified, or is null or
+ undefined, the denominator will be the lowest value necessary to represent the
+ number exactly.
+
+ See Errors for the treatment of other non-integer or out of range
+ max values.
+
+x = new BigNumber(1.75)
+x.toFraction() // '7, 4'
+
+pi = new BigNumber('3.14159265358')
+pi.toFraction() // '157079632679,50000000000'
+pi.toFraction(100000) // '312689, 99532'
+pi.toFraction(10000) // '355, 113'
+pi.toFraction(100) // '311, 99'
+pi.toFraction(10) // '22, 7'
+pi.toFraction(1) // '3, 1'
+
+
+
+ toJSON.toJSON() ⇒ string
+ As valueOf.
+x = new BigNumber('177.7e+457')
+y = new BigNumber(235.4325)
+z = new BigNumber('0.0098074')
+
+// Serialize an array of three BigNumbers
+str = JSON.stringify( [x, y, z] )
+// "["1.777e+459","235.4325","0.0098074"]"
+
+// Return an array of three BigNumbers
+JSON.parse(str, function (key, val) {
+ return key === '' ? val : new BigNumber(val)
+})
+
+
+
+ toNumber.toNumber() ⇒ number
+ Returns the value of this BigNumber as a JavaScript number primitive.
++ Type coercion with, for example, the unary plus operator will also work, except that a + BigNumber with the value minus zero will be converted to positive zero. +
+
+x = new BigNumber(456.789)
+x.toNumber() // 456.789
++x // 456.789
+
+y = new BigNumber('45987349857634085409857349856430985')
+y.toNumber() // 4.598734985763409e+34
+
+z = new BigNumber(-0)
+1 / +z // Infinity
+1 / z.toNumber() // -Infinity
+
+
+
+ toPower.pow(n) ⇒ BigNumber
+
+ n: number: integer,
+ -9007199254740991 to 9007199254740991 inclusive
+
+ Returns a BigNumber whose value is the value of this BigNumber raised to the power
+ n.
+
+ If n is negative the result is rounded according to the current
+ DECIMAL_PLACES and
+ ROUNDING_MODE configuration.
+
+ If n is not an integer or is out of range:
+
+ If ERRORS is true a BigNumber Error is thrown,
+ else if n is greater than 9007199254740991, it is interpreted as
+ Infinity;
+ else if n is less than -9007199254740991, it is interpreted as
+ -Infinity;
+ else if n is otherwise a number, it is truncated to an integer;
+ else it is interpreted as NaN.
+
+ As the number of digits of the result of the power operation can grow so large so quickly,
+ e.g. 123.45610000 has over 50000 digits, the number of significant
+ digits calculated is limited to the value of the
+ POW_PRECISION setting (default value:
+ 100).
+
+ Set POW_PRECISION to 0 for an
+ unlimited number of significant digits to be calculated (this will cause the method to slow
+ dramatically for larger exponents).
+
+ Negative exponents will be calculated to the number of decimal places specified by
+ DECIMAL_PLACES (but not to more than
+ POW_PRECISION significant digits).
+
+Math.pow(0.7, 2) // 0.48999999999999994 +x = new BigNumber(0.7) +x.toPower(2) // '0.49' +BigNumber(3).pow(-2) // '0.11111111111111111111'+ + + +
+ toPrecision.toPrecision([sd [, rm]]) ⇒ string
+
+
+ sd: number: integer, 1 to 1e+9 inclusive
+ rm: number: integer, 0 to 8 inclusive
+
+ Returns a string representing the value of this BigNumber rounded to sd
+ significant digits using rounding mode rm.
+
+ If sd is less than the number of digits necessary to represent the integer part
+ of the value in normal (fixed-point) notation, then exponential notation is used.
+
+ If sd is omitted, or is null or undefined, then the
+ return value is the same as n.toString().
+ If rm is omitted or is null or undefined,
+ ROUNDING_MODE is used.
+
+ See Errors for the treatment of other non-integer or out of range
+ sd or rm values.
+
+x = 45.6 +y = new BigNumber(x) +x.toPrecision() // '45.6' +y.toPrecision() // '45.6' +x.toPrecision(1) // '5e+1' +y.toPrecision(1) // '5e+1' +y.toPrecision(2, 0) // '4.6e+1' (ROUND_UP) +y.toPrecision(2, 1) // '4.5e+1' (ROUND_DOWN) +x.toPrecision(5) // '45.600' +y.toPrecision(5) // '45.600'+ + + +
toString.toString([base]) ⇒ string
+ base: number: integer, 2 to 64 inclusive
+ Returns a string representing the value of this BigNumber in the specified base, or base
+ 10 if base is omitted or is null or
+ undefined.
+
+ For bases above 10, values from 10 to 35 are
+ represented by a-z (as with Number.prototype.toString),
+ 36 to 61 by A-Z, and 62 and
+ 63 by $ and _ respectively.
+
+ If a base is specified the value is rounded according to the current
+ DECIMAL_PLACES
+ and ROUNDING_MODE configuration.
+
+ If a base is not specified, and this BigNumber has a positive
+ exponent that is equal to or greater than the positive component of the
+ current EXPONENTIAL_AT setting,
+ or a negative exponent equal to or less than the negative component of the
+ setting, then exponential notation is returned.
+
If base is null or undefined it is ignored.
+ See Errors for the treatment of other non-integer or out of range
+ base values.
+
+x = new BigNumber(750000)
+x.toString() // '750000'
+BigNumber.config({ EXPONENTIAL_AT: 5 })
+x.toString() // '7.5e+5'
+
+y = new BigNumber(362.875)
+y.toString(2) // '101101010.111'
+y.toString(9) // '442.77777777777777777778'
+y.toString(32) // 'ba.s'
+
+BigNumber.config({ DECIMAL_PLACES: 4 });
+z = new BigNumber('1.23456789')
+z.toString() // '1.23456789'
+z.toString(10) // '1.2346'
+
+
+
+ truncated.trunc() ⇒ BigNumber
+ + Returns a BigNumber whose value is the value of this BigNumber truncated to a whole number. +
++x = new BigNumber(123.456) +x.truncated() // '123' +y = new BigNumber(-12.3) +y.trunc() // '-12'+ + + +
valueOf.valueOf() ⇒ string
+
+ As toString, but does not accept a base argument and includes the minus sign
+ for negative zero.
+
+x = new BigNumber('-0')
+x.toString() // '0'
+x.valueOf() // '-0'
+y = new BigNumber('1.777e+457')
+y.valueOf() // '1.777e+457'
+
+
+
+ Properties
+A BigNumber is an object with three properties:
+| Property | +Description | +Type | +Value | +
|---|---|---|---|
| c | +coefficient* | +number[] |
+ Array of base 1e14 numbers |
+
| e | +exponent | +number | +Integer, -1000000000 to 1000000000 inclusive |
+
| s | +sign | +number | +-1 or 1 |
+
*significand
+The value of any of the three properties may also be null.
+ From v2.0.0 of this library, the value of the coefficient of a BigNumber is stored in a
+ normalised base 100000000000000 floating point format, as opposed to the base
+ 10 format used in v1.x.x
+
+ This change means the properties of a BigNumber are now best considered to be read-only. + Previously it was acceptable to change the exponent of a BigNumber by writing to its exponent + property directly, but this is no longer recommended as the number of digits in the first + element of the coefficient array is dependent on the exponent, so the coefficient would also + need to be altered. +
++ Note that, as with JavaScript numbers, the original exponent and fractional trailing zeros are + not necessarily preserved. +
+x = new BigNumber(0.123) // '0.123'
+x.toExponential() // '1.23e-1'
+x.c // '1,2,3'
+x.e // -1
+x.s // 1
+
+y = new Number(-123.4567000e+2) // '-12345.67'
+y.toExponential() // '-1.234567e+4'
+z = new BigNumber('-123.4567000e+2') // '-12345.67'
+z.toExponential() // '-1.234567e+4'
+z.c // '1,2,3,4,5,6,7'
+z.e // 4
+z.s // -1
+
+
+
+ Zero, NaN and Infinity
+
+ The table below shows how ±0, NaN and
+ ±Infinity are stored.
+
| + | c | +e | +s | +
|---|---|---|---|
| ±0 | +[0] |
+ 0 |
+ ±1 |
+
| NaN | +null |
+ null |
+ null |
+
| ±Infinity | +null |
+ null |
+ ±1 |
+
+x = new Number(-0) // 0 +1 / x == -Infinity // true + +y = new BigNumber(-0) // '0' +y.c // '0' ( [0].toString() ) +y.e // 0 +y.s // -1+ + + +
Errors
+
+ The errors that are thrown are generic Error objects with name
+ BigNumber Error.
+
+ The table below shows the errors that may be thrown if ERRORS is
+ true, and the action taken if ERRORS is false.
+
| Method(s) | +ERRORS: true Throw BigNumber Error |
+ ERRORS: false Action on invalid argument |
+
|---|---|---|
+
+ BigNumber |
+ number type has more than 15 significant digits |
+ Accept. | +
| not a base... number | +Substitute NaN. |
+ |
| base not an integer | +Truncate to integer. Ignore if not a number. |
+ |
| base out of range | +Ignore. | +|
| not a number* | +Substitute NaN. |
+ |
another |
+ not an object | +Ignore. | +
config |
+ DECIMAL_PLACES not an integer |
+ Truncate to integer. Ignore if not a number. |
+
DECIMAL_PLACES out of range |
+ Ignore. | +|
ROUNDING_MODE not an integer |
+ Truncate to integer. Ignore if not a number. |
+ |
ROUNDING_MODE out of range |
+ Ignore. | +|
EXPONENTIAL_AT not an integeror not [integer, integer] |
+ Truncate to integer(s). Ignore if not number(s). |
+ |
EXPONENTIAL_AT out of rangeor not [negative, positive] |
+ Ignore. | +|
RANGE not an integeror not [integer, integer] |
+ Truncate to integer(s). Ignore if not number(s). |
+ |
RANGE cannot be zero |
+ Ignore. | +|
RANGE out of rangeor not [negative, positive] |
+ Ignore. | +|
ERRORS not a booleanor binary digit |
+ Ignore. | +|
CRYPTO not a booleanor binary digit |
+ Ignore. | +|
CRYPTO crypto unavailable |
+ Ignore. | +|
MODULO_MODE not an integer |
+ Truncate to integer. Ignore if not a number. |
+ |
MODULO_MODE out of range |
+ Ignore. | +|
POW_PRECISION not an integer |
+ Truncate to integer. Ignore if not a number. |
+ |
POW_PRECISION out of range |
+ Ignore. | +|
FORMAT not an object |
+ Ignore. | +|
precision |
+ argument not a boolean or binary digit |
+ Ignore. | +
round |
+ decimal places not an integer | +Truncate to integer. Ignore if not a number. |
+
| decimal places out of range | +Ignore. | +|
| rounding mode not an integer | +Truncate to integer. Ignore if not a number. |
+ |
| rounding mode out of range | +Ignore. | +|
shift |
+ argument not an integer | +Truncate to integer. Ignore if not a number. |
+
| argument out of range | +Substitute ±Infinity.
+ | |
+ toExponential+ toFixed+ toFormat
+ |
+ decimal places not an integer | +Truncate to integer. Ignore if not a number. |
+
| decimal places out of range | +Ignore. | +|
| rounding mode not an integer | +Truncate to integer. Ignore if not a number. |
+ |
| rounding mode out of range | +Ignore. | +|
toFraction |
+ max denominator not an integer | +Truncate to integer. Ignore if not a number. |
+
| max denominator out of range | +Ignore. | +|
+ toDigits+ toPrecision
+ |
+ precision not an integer | +Truncate to integer. Ignore if not a number. |
+
| precision out of range | +Ignore. | +|
| rounding mode not an integer | +Truncate to integer. Ignore if not a number. |
+ |
| rounding mode out of range | +Ignore. | +|
toPower |
+ exponent not an integer | +Truncate to integer. Substitute NaN if not a number. |
+
| exponent out of range | +Substitute ±Infinity.
+ |
+ |
toString |
+ base not an integer | +Truncate to integer. Ignore if not a number. |
+
| base out of range | +Ignore. | +
*No error is thrown if the value is NaN or 'NaN'.
+ The message of a BigNumber Error will also contain the name of the method from which + the error originated. +
+To determine if an exception is a BigNumber Error:
+
+try {
+ // ...
+} catch (e) {
+ if ( e instanceof Error && e.name == 'BigNumber Error' ) {
+ // ...
+ }
+}
+
+
+
+ FAQ
+ +Why are trailing fractional zeros removed from BigNumbers?
++ Some arbitrary-precision libraries retain trailing fractional zeros as they can indicate the + precision of a value. This can be useful but the results of arithmetic operations can be + misleading. +
+
+x = new BigDecimal("1.0")
+y = new BigDecimal("1.1000")
+z = x.add(y) // 2.1000
+
+x = new BigDecimal("1.20")
+y = new BigDecimal("3.45000")
+z = x.multiply(y) // 4.1400000
+ + To specify the precision of a value is to specify that the value lies + within a certain range. +
+
+ In the first example, x has a value of 1.0. The trailing zero shows
+ the precision of the value, implying that it is in the range 0.95 to
+ 1.05. Similarly, the precision indicated by the trailing zeros of y
+ indicates that the value is in the range 1.09995 to 1.10005.
+
+ If we add the two lowest values in the ranges we have, 0.95 + 1.09995 = 2.04995,
+ and if we add the two highest values we have, 1.05 + 1.10005 = 2.15005, so the
+ range of the result of the addition implied by the precision of its operands is
+ 2.04995 to 2.15005.
+
+ The result given by BigDecimal of 2.1000 however, indicates that the value is in
+ the range 2.09995 to 2.10005 and therefore the precision implied by
+ its trailing zeros may be misleading.
+
+ In the second example, the true range is 4.122744 to 4.157256 yet
+ the BigDecimal answer of 4.1400000 indicates a range of 4.13999995
+ to 4.14000005. Again, the precision implied by the trailing zeros may be
+ misleading.
+
+ This library, like binary floating point and most calculators, does not retain trailing
+ fractional zeros. Instead, the toExponential, toFixed and
+ toPrecision methods enable trailing zeros to be added if and when required.
+
\r\n\r\n## Features\r\n\r\n - Faster, smaller, and perhaps easier to use than JavaScript versions of Java's BigDecimal\r\n - 8 KB minified and gzipped\r\n - Simple API but full-featured\r\n - Works with numbers with or without fraction digits in bases from 2 to 64 inclusive\r\n - Replicates the `toExponential`, `toFixed`, `toPrecision` and `toString` methods of JavaScript's Number type\r\n - Includes a `toFraction` and a correctly-rounded `squareRoot` method\r\n - Supports cryptographically-secure pseudo-random number generation\r\n - No dependencies\r\n - Wide platform compatibility: uses JavaScript 1.5 (ECMAScript 3) features only\r\n - Comprehensive [documentation](http://mikemcl.github.io/bignumber.js/) and test set\r\n\r\n\r\n\r\nIf a smaller and simpler library is required see [big.js](https://github.com/MikeMcl/big.js/).\r\nIt's less than half the size but only works with decimal numbers and only has half the methods.\r\nIt also does not allow `NaN` or `Infinity`, or have the configuration options of this library.\r\n\r\nSee also [decimal.js](https://github.com/MikeMcl/decimal.js/), which among other things adds support for non-integer powers, and performs all operations to a specified number of significant digits.\r\n\r\n## Load\r\n\r\nThe library is the single JavaScript file *bignumber.js* (or minified, *bignumber.min.js*).\r\n\r\n```html\r\n\r\n```\r\n\r\nFor [Node.js](http://nodejs.org) or [io.js](https://iojs.org/en/index.html), the library is available from the [npm](https://npmjs.org/) registry\r\n\r\n $ npm install bignumber.js\r\n\r\n```javascript\r\nvar BigNumber = require('bignumber.js');\r\n```\r\n\r\nTo load with AMD loader libraries such as [requireJS](http://requirejs.org/):\r\n\r\n```javascript\r\nrequire(['path/to/bignumber'], function(BigNumber) { \r\n // Use BigNumber here in local scope. No global BigNumber.\r\n});\r\n```\r\n\r\n## Use\r\n\r\n*In all examples below, `var`, semicolons and `toString` calls are not shown.\r\nIf a commented-out value is in quotes it means `toString` has been called on the preceding expression.*\r\n\r\nThe library exports a single function: `BigNumber`, the constructor of BigNumber instances.\r\n\r\nIt accepts a value of type number *(up to 15 significant digits only)*, string or BigNumber object,\r\n\r\n```javascript\r\nx = new BigNumber(123.4567)\r\ny = BigNumber('123456.7e-3')\r\nz = new BigNumber(x)\r\nx.equals(y) && y.equals(z) && x.equals(z) // true\r\n```\r\n\r\n\r\nand a base from 2 to 64 inclusive can be specified.\r\n\r\n```javascript\r\nx = new BigNumber(1011, 2) // \"11\"\r\ny = new BigNumber('zz.9', 36) // \"1295.25\"\r\nz = x.plus(y) // \"1306.25\"\r\n```\r\n\r\nA BigNumber is immutable in the sense that it is not changed by its methods. \r\n\r\n```javascript\r\n0.3 - 0.1 // 0.19999999999999998 \r\nx = new BigNumber(0.3)\r\nx.minus(0.1) // \"0.2\"\r\nx // \"0.3\"\r\n```\r\n\r\nThe methods that return a BigNumber can be chained.\r\n\r\n```javascript\r\nx.dividedBy(y).plus(z).times(9).floor()\r\nx.times('1.23456780123456789e+9').plus(9876.5432321).dividedBy('4444562598.111772').ceil()\r\n```\r\n\r\nMany method names have a shorter alias.\r\n\r\n```javascript\r\nx.squareRoot().dividedBy(y).toPower(3).equals(x.sqrt().div(y).pow(3)) // true\r\nx.cmp(y.mod(z).neg()) == 1 && x.comparedTo(y.modulo(z).negated()) == 1 // true\r\n```\r\n\r\nLike JavaScript's number type, there are `toExponential`, `toFixed` and `toPrecision` methods\r\n\r\n```javascript\r\nx = new BigNumber(255.5)\r\nx.toExponential(5) // \"2.55500e+2\"\r\nx.toFixed(5) // \"255.50000\"\r\nx.toPrecision(5) // \"255.50\"\r\nx.toNumber() // 255.5\r\n```\r\n\r\n and a base can be specified for `toString`.\r\n\r\n ```javascript\r\n x.toString(16) // \"ff.8\"\r\n ```\r\n\r\nThere is also a `toFormat` method which may be useful for internationalisation\r\n\r\n```javascript\r\ny = new BigNumber('1234567.898765')\r\ny.toFormat(2) // \"1,234,567.90\"\r\n```\r\n\r\nThe maximum number of decimal places of the result of an operation involving division (i.e. a division, square root, base conversion or negative power operation) is set using the `config` method of the `BigNumber` constructor.\r\n\r\nThe other arithmetic operations always give the exact result.\r\n\r\n```javascript\r\nBigNumber.config({ DECIMAL_PLACES: 10, ROUNDING_MODE: 4 })\r\n// Alternatively, BigNumber.config( 10, 4 );\r\n\r\nx = new BigNumber(2);\r\ny = new BigNumber(3);\r\nz = x.div(y) // \"0.6666666667\"\r\nz.sqrt() // \"0.8164965809\"\r\nz.pow(-3) // \"3.3749999995\"\r\nz.toString(2) // \"0.1010101011\"\r\nz.times(z) // \"0.44444444448888888889\"\r\nz.times(z).round(10) // \"0.4444444445\"\r\n```\r\n\r\nThere is a `toFraction` method with an optional *maximum denominator* argument\r\n\r\n```javascript\r\ny = new BigNumber(355)\r\npi = y.dividedBy(113) // \"3.1415929204\"\r\npi.toFraction() // [ \"7853982301\", \"2500000000\" ]\r\npi.toFraction(1000) // [ \"355\", \"113\" ]\r\n```\r\n\r\nand `isNaN` and `isFinite` methods, as `NaN` and `Infinity` are valid `BigNumber` values.\r\n\r\n```javascript\r\nx = new BigNumber(NaN) // \"NaN\"\r\ny = new BigNumber(Infinity) // \"Infinity\"\r\nx.isNaN() && !y.isNaN() && !x.isFinite() && !y.isFinite() // true\r\n```\r\n\r\nThe value of a BigNumber is stored in a decimal floating point format in terms of a coefficient, exponent and sign.\r\n\r\n\r\n```javascript\r\nx = new BigNumber(-123.456);\r\nx.c // [ 123, 45600000000000 ] coefficient (i.e. significand)\r\nx.e // 2 exponent\r\nx.s // -1 sign\r\n```\r\n\r\n\r\nMultiple BigNumber constructors can be created, each with their own independent configuration which applies to all BigNumber's created from it.\r\n\r\n```javascript\r\n// Set DECIMAL_PLACES for the original BigNumber constructor\r\nBigNumber.config({ DECIMAL_PLACES: 10 })\r\n\r\n// Create another BigNumber constructor, optionally passing in a configuration object\r\nBN = BigNumber.another({ DECIMAL_PLACES: 5 })\r\n\r\nx = new BigNumber(1)\r\ny = new BN(1)\r\n\r\nx.div(3) // '0.3333333333'\r\ny.div(3) // '0.33333'\r\n```\r\n\r\nFor futher information see the [API](http://mikemcl.github.io/bignumber.js/) reference in the *doc* directory.\r\n\r\n## Test\r\n\r\nThe *test* directory contains the test scripts for each method.\r\n\r\nThe tests can be run with Node or a browser. For Node use\r\n\r\n $ npm test\r\n\r\nor\r\n\r\n $ node test/every-test\r\n\r\nTo test a single method, e.g.\r\n\r\n $ node test/toFraction\r\n\r\nFor the browser, see *every-test.html* and *single-test.html* in the *test/browser* directory. \r\n\r\n*bignumber-vs-number.html* enables some of the methods of bignumber.js to be compared with those of JavaScript's number type. \r\n\r\n## Versions\r\n\r\nThis is version 2.x.x of the library, for version 1.x.x see the tagged releases or switch to the 'original' branch. The advantages of version 2 are that it is considerably faster for numbers with many digits and that there are a some added methods (see Change Log below). The disadvantages are more lines of code and increased code complexity, and the loss of simplicity in no longer having the coefficient of a BigNumber stored in base 10. The 'original' version will continue to be supported.\r\n\r\n## Performance\r\n\r\nSee the [README](https://github.com/MikeMcl/bignumber.js/tree/master/perf) in the *perf* directory.\r\n\r\n## Build\r\n\r\nFor Node, if [uglify-js](https://github.com/mishoo/UglifyJS2) is installed\r\n\r\n npm install uglify-js -g\r\n\r\nthen\r\n\r\n npm run build\r\n\r\nwill create *bignumber.min.js*.\r\n\r\nA source map will also be created in the root directory.\r\n\r\n## Feedback\r\n\r\nOpen an issue, or email \r\n\r\nMichael\r\n\r\nM8ch88l@gmail.com\r\n\r\n## Licence\r\n\r\nMIT.\r\n\r\nSee [LICENCE](https://github.com/MikeMcl/bignumber.js/blob/master/LICENCE).\r\n\r\n## Change Log\r\n\r\n####2.1.2\r\n* 10/12/2015\r\n* Bugfix: `window.crypto` not assigned to `crypto`.\r\n\r\n####2.1.1\r\n* 09/12/2015\r\n* Prevent code bundler from adding `crypto` shim.\r\n\r\n####2.1.0\r\n* 26/10/2015\r\n* For `valueOf` and `toJSON`, include the minus sign with negative zero.\r\n\r\n####2.0.8\r\n* 2/10/2015\r\n* Internal round function bugfix.\r\n\r\n####2.0.6\r\n* 31/03/2015\r\n* Add bower.json. Tweak division after in-depth review.\r\n\r\n####2.0.5\r\n* 25/03/2015\r\n* Amend README. Remove bitcoin address.\r\n\r\n####2.0.4\r\n* 25/03/2015\r\n* Critical bugfix #58: division.\r\n\r\n####2.0.3\r\n* 18/02/2015\r\n* Amend README. Add source map.\r\n\r\n####2.0.2\r\n* 18/02/2015\r\n* Correct links.\r\n\r\n####2.0.1\r\n* 18/02/2015\r\n* Add `max`, `min`, `precision`, `random`, `shift`, `toDigits` and `truncated` methods.\r\n* Add the short-forms: `add`, `mul`, `sd`, `sub` and `trunc`.\r\n* Add an `another` method to enable multiple independent constructors to be created.\r\n* Add support for the base 2, 8 and 16 prefixes `0b`, `0o` and `0x`.\r\n* Enable a rounding mode to be specified as a second parameter to `toExponential`, `toFixed`, `toFormat` and `toPrecision`.\r\n* Add a `CRYPTO` configuration property so cryptographically-secure pseudo-random number generation can be specified.\r\n* Add a `MODULO_MODE` configuration property to enable the rounding mode used by the `modulo` operation to be specified.\r\n* Add a `POW_PRECISION` configuration property to enable the number of significant digits calculated by the power operation to be limited.\r\n* Improve code quality.\r\n* Improve documentation.\r\n\r\n####2.0.0\r\n* 29/12/2014\r\n* Add `dividedToIntegerBy`, `isInteger` and `toFormat` methods.\r\n* Remove the following short-forms: `isF`, `isZ`, `toE`, `toF`, `toFr`, `toN`, `toP`, `toS`.\r\n* Store a BigNumber's coefficient in base 1e14, rather than base 10.\r\n* Add fast path for integers to BigNumber constructor.\r\n* Incorporate the library into the online documentation.\r\n\r\n####1.5.0\r\n* 13/11/2014\r\n* Add `toJSON` and `decimalPlaces` methods.\r\n\r\n####1.4.1\r\n* 08/06/2014\r\n* Amend README.\r\n\r\n####1.4.0\r\n* 08/05/2014\r\n* Add `toNumber`.\r\n\r\n####1.3.0\r\n* 08/11/2013\r\n* Ensure correct rounding of `sqrt` in all, rather than almost all, cases.\r\n* Maximum radix to 64.\r\n\r\n####1.2.1\r\n* 17/10/2013\r\n* Sign of zero when x < 0 and x + (-x) = 0.\r\n\r\n####1.2.0\r\n* 19/9/2013\r\n* Throw Error objects for stack.\r\n\r\n####1.1.1\r\n* 22/8/2013\r\n* Show original value in constructor error message.\r\n\r\n####1.1.0\r\n* 1/8/2013\r\n* Allow numbers with trailing radix point. \r\n\r\n####1.0.1\r\n* Bugfix: error messages with incorrect method name\r\n\r\n####1.0.0\r\n* 8/11/2012\r\n* Initial release\r\n", + "readmeFilename": "README.md", + "bugs": { + "url": "https://github.com/MikeMcl/bignumber.js/issues" + }, + "_id": "bignumber.js@2.1.2", + "_from": "bignumber.js@2.1.2" +} diff --git a/nodejs/node_modules/mysql/node_modules/readable-stream/.npmignore b/nodejs/node_modules/mysql/node_modules/readable-stream/.npmignore new file mode 100644 index 0000000..38344f8 --- /dev/null +++ b/nodejs/node_modules/mysql/node_modules/readable-stream/.npmignore @@ -0,0 +1,5 @@ +build/ +test/ +examples/ +fs.js +zlib.js \ No newline at end of file diff --git a/nodejs/node_modules/mysql/node_modules/readable-stream/LICENSE b/nodejs/node_modules/mysql/node_modules/readable-stream/LICENSE new file mode 100644 index 0000000..e3d4e69 --- /dev/null +++ b/nodejs/node_modules/mysql/node_modules/readable-stream/LICENSE @@ -0,0 +1,18 @@ +Copyright Joyent, Inc. and other Node contributors. All rights reserved. +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to +deal in the Software without restriction, including without limitation the +rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS +IN THE SOFTWARE. diff --git a/nodejs/node_modules/mysql/node_modules/readable-stream/README.md b/nodejs/node_modules/mysql/node_modules/readable-stream/README.md new file mode 100644 index 0000000..e46b823 --- /dev/null +++ b/nodejs/node_modules/mysql/node_modules/readable-stream/README.md @@ -0,0 +1,15 @@ +# readable-stream + +***Node-core streams for userland*** + +[](https://nodei.co/npm/readable-stream/) +[](https://nodei.co/npm/readable-stream/) + +This package is a mirror of the Streams2 and Streams3 implementations in Node-core. + +If you want to guarantee a stable streams base, regardless of what version of Node you, or the users of your libraries are using, use **readable-stream** *only* and avoid the *"stream"* module in Node-core. + +**readable-stream** comes in two major versions, v1.0.x and v1.1.x. The former tracks the Streams2 implementation in Node 0.10, including bug-fixes and minor improvements as they are added. The latter tracks Streams3 as it develops in Node 0.11; we will likely see a v1.2.x branch for Node 0.12. + +**readable-stream** uses proper patch-level versioning so if you pin to `"~1.0.0"` you’ll get the latest Node 0.10 Streams2 implementation, including any fixes and minor non-breaking improvements. The patch-level versions of 1.0.x and 1.1.x should mirror the patch-level versions of Node-core releases. You should prefer the **1.0.x** releases for now and when you’re ready to start using Streams3, pin to `"~1.1.0"` + diff --git a/nodejs/node_modules/mysql/node_modules/readable-stream/duplex.js b/nodejs/node_modules/mysql/node_modules/readable-stream/duplex.js new file mode 100644 index 0000000..ca807af --- /dev/null +++ b/nodejs/node_modules/mysql/node_modules/readable-stream/duplex.js @@ -0,0 +1 @@ +module.exports = require("./lib/_stream_duplex.js") diff --git a/nodejs/node_modules/mysql/node_modules/readable-stream/float.patch b/nodejs/node_modules/mysql/node_modules/readable-stream/float.patch new file mode 100644 index 0000000..b984607 --- /dev/null +++ b/nodejs/node_modules/mysql/node_modules/readable-stream/float.patch @@ -0,0 +1,923 @@ +diff --git a/lib/_stream_duplex.js b/lib/_stream_duplex.js +index c5a741c..a2e0d8e 100644 +--- a/lib/_stream_duplex.js ++++ b/lib/_stream_duplex.js +@@ -26,8 +26,8 @@ + + module.exports = Duplex; + var util = require('util'); +-var Readable = require('_stream_readable'); +-var Writable = require('_stream_writable'); ++var Readable = require('./_stream_readable'); ++var Writable = require('./_stream_writable'); + + util.inherits(Duplex, Readable); + +diff --git a/lib/_stream_passthrough.js b/lib/_stream_passthrough.js +index a5e9864..330c247 100644 +--- a/lib/_stream_passthrough.js ++++ b/lib/_stream_passthrough.js +@@ -25,7 +25,7 @@ + + module.exports = PassThrough; + +-var Transform = require('_stream_transform'); ++var Transform = require('./_stream_transform'); + var util = require('util'); + util.inherits(PassThrough, Transform); + +diff --git a/lib/_stream_readable.js b/lib/_stream_readable.js +index 0c3fe3e..90a8298 100644 +--- a/lib/_stream_readable.js ++++ b/lib/_stream_readable.js +@@ -23,10 +23,34 @@ module.exports = Readable; + Readable.ReadableState = ReadableState; + + var EE = require('events').EventEmitter; ++if (!EE.listenerCount) EE.listenerCount = function(emitter, type) { ++ return emitter.listeners(type).length; ++}; ++ ++if (!global.setImmediate) global.setImmediate = function setImmediate(fn) { ++ return setTimeout(fn, 0); ++}; ++if (!global.clearImmediate) global.clearImmediate = function clearImmediate(i) { ++ return clearTimeout(i); ++}; ++ + var Stream = require('stream'); + var util = require('util'); ++if (!util.isUndefined) { ++ var utilIs = require('core-util-is'); ++ for (var f in utilIs) { ++ util[f] = utilIs[f]; ++ } ++} + var StringDecoder; +-var debug = util.debuglog('stream'); ++var debug; ++if (util.debuglog) ++ debug = util.debuglog('stream'); ++else try { ++ debug = require('debuglog')('stream'); ++} catch (er) { ++ debug = function() {}; ++} + + util.inherits(Readable, Stream); + +@@ -380,7 +404,7 @@ function chunkInvalid(state, chunk) { + + + function onEofChunk(stream, state) { +- if (state.decoder && !state.ended) { ++ if (state.decoder && !state.ended && state.decoder.end) { + var chunk = state.decoder.end(); + if (chunk && chunk.length) { + state.buffer.push(chunk); +diff --git a/lib/_stream_transform.js b/lib/_stream_transform.js +index b1f9fcc..b0caf57 100644 +--- a/lib/_stream_transform.js ++++ b/lib/_stream_transform.js +@@ -64,8 +64,14 @@ + + module.exports = Transform; + +-var Duplex = require('_stream_duplex'); ++var Duplex = require('./_stream_duplex'); + var util = require('util'); ++if (!util.isUndefined) { ++ var utilIs = require('core-util-is'); ++ for (var f in utilIs) { ++ util[f] = utilIs[f]; ++ } ++} + util.inherits(Transform, Duplex); + + +diff --git a/lib/_stream_writable.js b/lib/_stream_writable.js +index ba2e920..f49288b 100644 +--- a/lib/_stream_writable.js ++++ b/lib/_stream_writable.js +@@ -27,6 +27,12 @@ module.exports = Writable; + Writable.WritableState = WritableState; + + var util = require('util'); ++if (!util.isUndefined) { ++ var utilIs = require('core-util-is'); ++ for (var f in utilIs) { ++ util[f] = utilIs[f]; ++ } ++} + var Stream = require('stream'); + + util.inherits(Writable, Stream); +@@ -119,7 +125,7 @@ function WritableState(options, stream) { + function Writable(options) { + // Writable ctor is applied to Duplexes, though they're not + // instanceof Writable, they're instanceof Readable. +- if (!(this instanceof Writable) && !(this instanceof Stream.Duplex)) ++ if (!(this instanceof Writable) && !(this instanceof require('./_stream_duplex'))) + return new Writable(options); + + this._writableState = new WritableState(options, this); +diff --git a/test/simple/test-stream-big-push.js b/test/simple/test-stream-big-push.js +index e3787e4..8cd2127 100644 +--- a/test/simple/test-stream-big-push.js ++++ b/test/simple/test-stream-big-push.js +@@ -21,7 +21,7 @@ + + var common = require('../common'); + var assert = require('assert'); +-var stream = require('stream'); ++var stream = require('../../'); + var str = 'asdfasdfasdfasdfasdf'; + + var r = new stream.Readable({ +diff --git a/test/simple/test-stream-end-paused.js b/test/simple/test-stream-end-paused.js +index bb73777..d40efc7 100644 +--- a/test/simple/test-stream-end-paused.js ++++ b/test/simple/test-stream-end-paused.js +@@ -25,7 +25,7 @@ var gotEnd = false; + + // Make sure we don't miss the end event for paused 0-length streams + +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + var stream = new Readable(); + var calledRead = false; + stream._read = function() { +diff --git a/test/simple/test-stream-pipe-after-end.js b/test/simple/test-stream-pipe-after-end.js +index b46ee90..0be8366 100644 +--- a/test/simple/test-stream-pipe-after-end.js ++++ b/test/simple/test-stream-pipe-after-end.js +@@ -22,8 +22,8 @@ + var common = require('../common'); + var assert = require('assert'); + +-var Readable = require('_stream_readable'); +-var Writable = require('_stream_writable'); ++var Readable = require('../../lib/_stream_readable'); ++var Writable = require('../../lib/_stream_writable'); + var util = require('util'); + + util.inherits(TestReadable, Readable); +diff --git a/test/simple/test-stream-pipe-cleanup.js b/test/simple/test-stream-pipe-cleanup.js +deleted file mode 100644 +index f689358..0000000 +--- a/test/simple/test-stream-pipe-cleanup.js ++++ /dev/null +@@ -1,122 +0,0 @@ +-// Copyright Joyent, Inc. and other Node contributors. +-// +-// Permission is hereby granted, free of charge, to any person obtaining a +-// copy of this software and associated documentation files (the +-// "Software"), to deal in the Software without restriction, including +-// without limitation the rights to use, copy, modify, merge, publish, +-// distribute, sublicense, and/or sell copies of the Software, and to permit +-// persons to whom the Software is furnished to do so, subject to the +-// following conditions: +-// +-// The above copyright notice and this permission notice shall be included +-// in all copies or substantial portions of the Software. +-// +-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +-// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +-// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +-// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +-// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +-// USE OR OTHER DEALINGS IN THE SOFTWARE. +- +-// This test asserts that Stream.prototype.pipe does not leave listeners +-// hanging on the source or dest. +- +-var common = require('../common'); +-var stream = require('stream'); +-var assert = require('assert'); +-var util = require('util'); +- +-function Writable() { +- this.writable = true; +- this.endCalls = 0; +- stream.Stream.call(this); +-} +-util.inherits(Writable, stream.Stream); +-Writable.prototype.end = function() { +- this.endCalls++; +-}; +- +-Writable.prototype.destroy = function() { +- this.endCalls++; +-}; +- +-function Readable() { +- this.readable = true; +- stream.Stream.call(this); +-} +-util.inherits(Readable, stream.Stream); +- +-function Duplex() { +- this.readable = true; +- Writable.call(this); +-} +-util.inherits(Duplex, Writable); +- +-var i = 0; +-var limit = 100; +- +-var w = new Writable(); +- +-var r; +- +-for (i = 0; i < limit; i++) { +- r = new Readable(); +- r.pipe(w); +- r.emit('end'); +-} +-assert.equal(0, r.listeners('end').length); +-assert.equal(limit, w.endCalls); +- +-w.endCalls = 0; +- +-for (i = 0; i < limit; i++) { +- r = new Readable(); +- r.pipe(w); +- r.emit('close'); +-} +-assert.equal(0, r.listeners('close').length); +-assert.equal(limit, w.endCalls); +- +-w.endCalls = 0; +- +-r = new Readable(); +- +-for (i = 0; i < limit; i++) { +- w = new Writable(); +- r.pipe(w); +- w.emit('close'); +-} +-assert.equal(0, w.listeners('close').length); +- +-r = new Readable(); +-w = new Writable(); +-var d = new Duplex(); +-r.pipe(d); // pipeline A +-d.pipe(w); // pipeline B +-assert.equal(r.listeners('end').length, 2); // A.onend, A.cleanup +-assert.equal(r.listeners('close').length, 2); // A.onclose, A.cleanup +-assert.equal(d.listeners('end').length, 2); // B.onend, B.cleanup +-assert.equal(d.listeners('close').length, 3); // A.cleanup, B.onclose, B.cleanup +-assert.equal(w.listeners('end').length, 0); +-assert.equal(w.listeners('close').length, 1); // B.cleanup +- +-r.emit('end'); +-assert.equal(d.endCalls, 1); +-assert.equal(w.endCalls, 0); +-assert.equal(r.listeners('end').length, 0); +-assert.equal(r.listeners('close').length, 0); +-assert.equal(d.listeners('end').length, 2); // B.onend, B.cleanup +-assert.equal(d.listeners('close').length, 2); // B.onclose, B.cleanup +-assert.equal(w.listeners('end').length, 0); +-assert.equal(w.listeners('close').length, 1); // B.cleanup +- +-d.emit('end'); +-assert.equal(d.endCalls, 1); +-assert.equal(w.endCalls, 1); +-assert.equal(r.listeners('end').length, 0); +-assert.equal(r.listeners('close').length, 0); +-assert.equal(d.listeners('end').length, 0); +-assert.equal(d.listeners('close').length, 0); +-assert.equal(w.listeners('end').length, 0); +-assert.equal(w.listeners('close').length, 0); +diff --git a/test/simple/test-stream-pipe-error-handling.js b/test/simple/test-stream-pipe-error-handling.js +index c5d724b..c7d6b7d 100644 +--- a/test/simple/test-stream-pipe-error-handling.js ++++ b/test/simple/test-stream-pipe-error-handling.js +@@ -21,7 +21,7 @@ + + var common = require('../common'); + var assert = require('assert'); +-var Stream = require('stream').Stream; ++var Stream = require('../../').Stream; + + (function testErrorListenerCatches() { + var source = new Stream(); +diff --git a/test/simple/test-stream-pipe-event.js b/test/simple/test-stream-pipe-event.js +index cb9d5fe..56f8d61 100644 +--- a/test/simple/test-stream-pipe-event.js ++++ b/test/simple/test-stream-pipe-event.js +@@ -20,7 +20,7 @@ + // USE OR OTHER DEALINGS IN THE SOFTWARE. + + var common = require('../common'); +-var stream = require('stream'); ++var stream = require('../../'); + var assert = require('assert'); + var util = require('util'); + +diff --git a/test/simple/test-stream-push-order.js b/test/simple/test-stream-push-order.js +index f2e6ec2..a5c9bf9 100644 +--- a/test/simple/test-stream-push-order.js ++++ b/test/simple/test-stream-push-order.js +@@ -20,7 +20,7 @@ + // USE OR OTHER DEALINGS IN THE SOFTWARE. + + var common = require('../common.js'); +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + var assert = require('assert'); + + var s = new Readable({ +diff --git a/test/simple/test-stream-push-strings.js b/test/simple/test-stream-push-strings.js +index 06f43dc..1701a9a 100644 +--- a/test/simple/test-stream-push-strings.js ++++ b/test/simple/test-stream-push-strings.js +@@ -22,7 +22,7 @@ + var common = require('../common'); + var assert = require('assert'); + +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + var util = require('util'); + + util.inherits(MyStream, Readable); +diff --git a/test/simple/test-stream-readable-event.js b/test/simple/test-stream-readable-event.js +index ba6a577..a8e6f7b 100644 +--- a/test/simple/test-stream-readable-event.js ++++ b/test/simple/test-stream-readable-event.js +@@ -22,7 +22,7 @@ + var common = require('../common'); + var assert = require('assert'); + +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + + (function first() { + // First test, not reading when the readable is added. +diff --git a/test/simple/test-stream-readable-flow-recursion.js b/test/simple/test-stream-readable-flow-recursion.js +index 2891ad6..11689ba 100644 +--- a/test/simple/test-stream-readable-flow-recursion.js ++++ b/test/simple/test-stream-readable-flow-recursion.js +@@ -27,7 +27,7 @@ var assert = require('assert'); + // more data continuously, but without triggering a nextTick + // warning or RangeError. + +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + + // throw an error if we trigger a nextTick warning. + process.throwDeprecation = true; +diff --git a/test/simple/test-stream-unshift-empty-chunk.js b/test/simple/test-stream-unshift-empty-chunk.js +index 0c96476..7827538 100644 +--- a/test/simple/test-stream-unshift-empty-chunk.js ++++ b/test/simple/test-stream-unshift-empty-chunk.js +@@ -24,7 +24,7 @@ var assert = require('assert'); + + // This test verifies that stream.unshift(Buffer(0)) or + // stream.unshift('') does not set state.reading=false. +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + + var r = new Readable(); + var nChunks = 10; +diff --git a/test/simple/test-stream-unshift-read-race.js b/test/simple/test-stream-unshift-read-race.js +index 83fd9fa..17c18aa 100644 +--- a/test/simple/test-stream-unshift-read-race.js ++++ b/test/simple/test-stream-unshift-read-race.js +@@ -29,7 +29,7 @@ var assert = require('assert'); + // 3. push() after the EOF signaling null is an error. + // 4. _read() is not called after pushing the EOF null chunk. + +-var stream = require('stream'); ++var stream = require('../../'); + var hwm = 10; + var r = stream.Readable({ highWaterMark: hwm }); + var chunks = 10; +@@ -51,7 +51,14 @@ r._read = function(n) { + + function push(fast) { + assert(!pushedNull, 'push() after null push'); +- var c = pos >= data.length ? null : data.slice(pos, pos + n); ++ var c; ++ if (pos >= data.length) ++ c = null; ++ else { ++ if (n + pos > data.length) ++ n = data.length - pos; ++ c = data.slice(pos, pos + n); ++ } + pushedNull = c === null; + if (fast) { + pos += n; +diff --git a/test/simple/test-stream-writev.js b/test/simple/test-stream-writev.js +index 5b49e6e..b5321f3 100644 +--- a/test/simple/test-stream-writev.js ++++ b/test/simple/test-stream-writev.js +@@ -22,7 +22,7 @@ + var common = require('../common'); + var assert = require('assert'); + +-var stream = require('stream'); ++var stream = require('../../'); + + var queue = []; + for (var decode = 0; decode < 2; decode++) { +diff --git a/test/simple/test-stream2-basic.js b/test/simple/test-stream2-basic.js +index 3814bf0..248c1be 100644 +--- a/test/simple/test-stream2-basic.js ++++ b/test/simple/test-stream2-basic.js +@@ -21,7 +21,7 @@ + + + var common = require('../common.js'); +-var R = require('_stream_readable'); ++var R = require('../../lib/_stream_readable'); + var assert = require('assert'); + + var util = require('util'); +diff --git a/test/simple/test-stream2-compatibility.js b/test/simple/test-stream2-compatibility.js +index 6cdd4e9..f0fa84b 100644 +--- a/test/simple/test-stream2-compatibility.js ++++ b/test/simple/test-stream2-compatibility.js +@@ -21,7 +21,7 @@ + + + var common = require('../common.js'); +-var R = require('_stream_readable'); ++var R = require('../../lib/_stream_readable'); + var assert = require('assert'); + + var util = require('util'); +diff --git a/test/simple/test-stream2-finish-pipe.js b/test/simple/test-stream2-finish-pipe.js +index 39b274f..006a19b 100644 +--- a/test/simple/test-stream2-finish-pipe.js ++++ b/test/simple/test-stream2-finish-pipe.js +@@ -20,7 +20,7 @@ + // USE OR OTHER DEALINGS IN THE SOFTWARE. + + var common = require('../common.js'); +-var stream = require('stream'); ++var stream = require('../../'); + var Buffer = require('buffer').Buffer; + + var r = new stream.Readable(); +diff --git a/test/simple/test-stream2-fs.js b/test/simple/test-stream2-fs.js +deleted file mode 100644 +index e162406..0000000 +--- a/test/simple/test-stream2-fs.js ++++ /dev/null +@@ -1,72 +0,0 @@ +-// Copyright Joyent, Inc. and other Node contributors. +-// +-// Permission is hereby granted, free of charge, to any person obtaining a +-// copy of this software and associated documentation files (the +-// "Software"), to deal in the Software without restriction, including +-// without limitation the rights to use, copy, modify, merge, publish, +-// distribute, sublicense, and/or sell copies of the Software, and to permit +-// persons to whom the Software is furnished to do so, subject to the +-// following conditions: +-// +-// The above copyright notice and this permission notice shall be included +-// in all copies or substantial portions of the Software. +-// +-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +-// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +-// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +-// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +-// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +-// USE OR OTHER DEALINGS IN THE SOFTWARE. +- +- +-var common = require('../common.js'); +-var R = require('_stream_readable'); +-var assert = require('assert'); +- +-var fs = require('fs'); +-var FSReadable = fs.ReadStream; +- +-var path = require('path'); +-var file = path.resolve(common.fixturesDir, 'x1024.txt'); +- +-var size = fs.statSync(file).size; +- +-var expectLengths = [1024]; +- +-var util = require('util'); +-var Stream = require('stream'); +- +-util.inherits(TestWriter, Stream); +- +-function TestWriter() { +- Stream.apply(this); +- this.buffer = []; +- this.length = 0; +-} +- +-TestWriter.prototype.write = function(c) { +- this.buffer.push(c.toString()); +- this.length += c.length; +- return true; +-}; +- +-TestWriter.prototype.end = function(c) { +- if (c) this.buffer.push(c.toString()); +- this.emit('results', this.buffer); +-} +- +-var r = new FSReadable(file); +-var w = new TestWriter(); +- +-w.on('results', function(res) { +- console.error(res, w.length); +- assert.equal(w.length, size); +- var l = 0; +- assert.deepEqual(res.map(function (c) { +- return c.length; +- }), expectLengths); +- console.log('ok'); +-}); +- +-r.pipe(w); +diff --git a/test/simple/test-stream2-httpclient-response-end.js b/test/simple/test-stream2-httpclient-response-end.js +deleted file mode 100644 +index 15cffc2..0000000 +--- a/test/simple/test-stream2-httpclient-response-end.js ++++ /dev/null +@@ -1,52 +0,0 @@ +-// Copyright Joyent, Inc. and other Node contributors. +-// +-// Permission is hereby granted, free of charge, to any person obtaining a +-// copy of this software and associated documentation files (the +-// "Software"), to deal in the Software without restriction, including +-// without limitation the rights to use, copy, modify, merge, publish, +-// distribute, sublicense, and/or sell copies of the Software, and to permit +-// persons to whom the Software is furnished to do so, subject to the +-// following conditions: +-// +-// The above copyright notice and this permission notice shall be included +-// in all copies or substantial portions of the Software. +-// +-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +-// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +-// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +-// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +-// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +-// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +-// USE OR OTHER DEALINGS IN THE SOFTWARE. +- +-var common = require('../common.js'); +-var assert = require('assert'); +-var http = require('http'); +-var msg = 'Hello'; +-var readable_event = false; +-var end_event = false; +-var server = http.createServer(function(req, res) { +- res.writeHead(200, {'Content-Type': 'text/plain'}); +- res.end(msg); +-}).listen(common.PORT, function() { +- http.get({port: common.PORT}, function(res) { +- var data = ''; +- res.on('readable', function() { +- console.log('readable event'); +- readable_event = true; +- data += res.read(); +- }); +- res.on('end', function() { +- console.log('end event'); +- end_event = true; +- assert.strictEqual(msg, data); +- server.close(); +- }); +- }); +-}); +- +-process.on('exit', function() { +- assert(readable_event); +- assert(end_event); +-}); +- +diff --git a/test/simple/test-stream2-large-read-stall.js b/test/simple/test-stream2-large-read-stall.js +index 2fbfbca..667985b 100644 +--- a/test/simple/test-stream2-large-read-stall.js ++++ b/test/simple/test-stream2-large-read-stall.js +@@ -30,7 +30,7 @@ var PUSHSIZE = 20; + var PUSHCOUNT = 1000; + var HWM = 50; + +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + var r = new Readable({ + highWaterMark: HWM + }); +@@ -39,23 +39,23 @@ var rs = r._readableState; + r._read = push; + + r.on('readable', function() { +- console.error('>> readable'); ++ //console.error('>> readable'); + do { +- console.error(' > read(%d)', READSIZE); ++ //console.error(' > read(%d)', READSIZE); + var ret = r.read(READSIZE); +- console.error(' < %j (%d remain)', ret && ret.length, rs.length); ++ //console.error(' < %j (%d remain)', ret && ret.length, rs.length); + } while (ret && ret.length === READSIZE); + +- console.error('<< after read()', +- ret && ret.length, +- rs.needReadable, +- rs.length); ++ //console.error('<< after read()', ++ // ret && ret.length, ++ // rs.needReadable, ++ // rs.length); + }); + + var endEmitted = false; + r.on('end', function() { + endEmitted = true; +- console.error('end'); ++ //console.error('end'); + }); + + var pushes = 0; +@@ -64,11 +64,11 @@ function push() { + return; + + if (pushes++ === PUSHCOUNT) { +- console.error(' push(EOF)'); ++ //console.error(' push(EOF)'); + return r.push(null); + } + +- console.error(' push #%d', pushes); ++ //console.error(' push #%d', pushes); + if (r.push(new Buffer(PUSHSIZE))) + setTimeout(push); + } +diff --git a/test/simple/test-stream2-objects.js b/test/simple/test-stream2-objects.js +index 3e6931d..ff47d89 100644 +--- a/test/simple/test-stream2-objects.js ++++ b/test/simple/test-stream2-objects.js +@@ -21,8 +21,8 @@ + + + var common = require('../common.js'); +-var Readable = require('_stream_readable'); +-var Writable = require('_stream_writable'); ++var Readable = require('../../lib/_stream_readable'); ++var Writable = require('../../lib/_stream_writable'); + var assert = require('assert'); + + // tiny node-tap lookalike. +diff --git a/test/simple/test-stream2-pipe-error-handling.js b/test/simple/test-stream2-pipe-error-handling.js +index cf7531c..e3f3e4e 100644 +--- a/test/simple/test-stream2-pipe-error-handling.js ++++ b/test/simple/test-stream2-pipe-error-handling.js +@@ -21,7 +21,7 @@ + + var common = require('../common'); + var assert = require('assert'); +-var stream = require('stream'); ++var stream = require('../../'); + + (function testErrorListenerCatches() { + var count = 1000; +diff --git a/test/simple/test-stream2-pipe-error-once-listener.js b/test/simple/test-stream2-pipe-error-once-listener.js +index 5e8e3cb..53b2616 100755 +--- a/test/simple/test-stream2-pipe-error-once-listener.js ++++ b/test/simple/test-stream2-pipe-error-once-listener.js +@@ -24,7 +24,7 @@ var common = require('../common.js'); + var assert = require('assert'); + + var util = require('util'); +-var stream = require('stream'); ++var stream = require('../../'); + + + var Read = function() { +diff --git a/test/simple/test-stream2-push.js b/test/simple/test-stream2-push.js +index b63edc3..eb2b0e9 100644 +--- a/test/simple/test-stream2-push.js ++++ b/test/simple/test-stream2-push.js +@@ -20,7 +20,7 @@ + // USE OR OTHER DEALINGS IN THE SOFTWARE. + + var common = require('../common.js'); +-var stream = require('stream'); ++var stream = require('../../'); + var Readable = stream.Readable; + var Writable = stream.Writable; + var assert = require('assert'); +diff --git a/test/simple/test-stream2-read-sync-stack.js b/test/simple/test-stream2-read-sync-stack.js +index e8a7305..9740a47 100644 +--- a/test/simple/test-stream2-read-sync-stack.js ++++ b/test/simple/test-stream2-read-sync-stack.js +@@ -21,7 +21,7 @@ + + var common = require('../common'); + var assert = require('assert'); +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + var r = new Readable(); + var N = 256 * 1024; + +diff --git a/test/simple/test-stream2-readable-empty-buffer-no-eof.js b/test/simple/test-stream2-readable-empty-buffer-no-eof.js +index cd30178..4b1659d 100644 +--- a/test/simple/test-stream2-readable-empty-buffer-no-eof.js ++++ b/test/simple/test-stream2-readable-empty-buffer-no-eof.js +@@ -22,10 +22,9 @@ + var common = require('../common'); + var assert = require('assert'); + +-var Readable = require('stream').Readable; ++var Readable = require('../../').Readable; + + test1(); +-test2(); + + function test1() { + var r = new Readable(); +@@ -88,31 +87,3 @@ function test1() { + console.log('ok'); + }); + } +- +-function test2() { +- var r = new Readable({ encoding: 'base64' }); +- var reads = 5; +- r._read = function(n) { +- if (!reads--) +- return r.push(null); // EOF +- else +- return r.push(new Buffer('x')); +- }; +- +- var results = []; +- function flow() { +- var chunk; +- while (null !== (chunk = r.read())) +- results.push(chunk + ''); +- } +- r.on('readable', flow); +- r.on('end', function() { +- results.push('EOF'); +- }); +- flow(); +- +- process.on('exit', function() { +- assert.deepEqual(results, [ 'eHh4', 'eHg=', 'EOF' ]); +- console.log('ok'); +- }); +-} +diff --git a/test/simple/test-stream2-readable-from-list.js b/test/simple/test-stream2-readable-from-list.js +index 7c96ffe..04a96f5 100644 +--- a/test/simple/test-stream2-readable-from-list.js ++++ b/test/simple/test-stream2-readable-from-list.js +@@ -21,7 +21,7 @@ + + var assert = require('assert'); + var common = require('../common.js'); +-var fromList = require('_stream_readable')._fromList; ++var fromList = require('../../lib/_stream_readable')._fromList; + + // tiny node-tap lookalike. + var tests = []; +diff --git a/test/simple/test-stream2-readable-legacy-drain.js b/test/simple/test-stream2-readable-legacy-drain.js +index 675da8e..51fd3d5 100644 +--- a/test/simple/test-stream2-readable-legacy-drain.js ++++ b/test/simple/test-stream2-readable-legacy-drain.js +@@ -22,7 +22,7 @@ + var common = require('../common'); + var assert = require('assert'); + +-var Stream = require('stream'); ++var Stream = require('../../'); + var Readable = Stream.Readable; + + var r = new Readable(); +diff --git a/test/simple/test-stream2-readable-non-empty-end.js b/test/simple/test-stream2-readable-non-empty-end.js +index 7314ae7..c971898 100644 +--- a/test/simple/test-stream2-readable-non-empty-end.js ++++ b/test/simple/test-stream2-readable-non-empty-end.js +@@ -21,7 +21,7 @@ + + var assert = require('assert'); + var common = require('../common.js'); +-var Readable = require('_stream_readable'); ++var Readable = require('../../lib/_stream_readable'); + + var len = 0; + var chunks = new Array(10); +diff --git a/test/simple/test-stream2-readable-wrap-empty.js b/test/simple/test-stream2-readable-wrap-empty.js +index 2e5cf25..fd8a3dc 100644 +--- a/test/simple/test-stream2-readable-wrap-empty.js ++++ b/test/simple/test-stream2-readable-wrap-empty.js +@@ -22,7 +22,7 @@ + var common = require('../common'); + var assert = require('assert'); + +-var Readable = require('_stream_readable'); ++var Readable = require('../../lib/_stream_readable'); + var EE = require('events').EventEmitter; + + var oldStream = new EE(); +diff --git a/test/simple/test-stream2-readable-wrap.js b/test/simple/test-stream2-readable-wrap.js +index 90eea01..6b177f7 100644 +--- a/test/simple/test-stream2-readable-wrap.js ++++ b/test/simple/test-stream2-readable-wrap.js +@@ -22,8 +22,8 @@ + var common = require('../common'); + var assert = require('assert'); + +-var Readable = require('_stream_readable'); +-var Writable = require('_stream_writable'); ++var Readable = require('../../lib/_stream_readable'); ++var Writable = require('../../lib/_stream_writable'); + var EE = require('events').EventEmitter; + + var testRuns = 0, completedRuns = 0; +diff --git a/test/simple/test-stream2-set-encoding.js b/test/simple/test-stream2-set-encoding.js +index 5d2c32a..685531b 100644 +--- a/test/simple/test-stream2-set-encoding.js ++++ b/test/simple/test-stream2-set-encoding.js +@@ -22,7 +22,7 @@ + + var common = require('../common.js'); + var assert = require('assert'); +-var R = require('_stream_readable'); ++var R = require('../../lib/_stream_readable'); + var util = require('util'); + + // tiny node-tap lookalike. +diff --git a/test/simple/test-stream2-transform.js b/test/simple/test-stream2-transform.js +index 9c9ddd8..a0cacc6 100644 +--- a/test/simple/test-stream2-transform.js ++++ b/test/simple/test-stream2-transform.js +@@ -21,8 +21,8 @@ + + var assert = require('assert'); + var common = require('../common.js'); +-var PassThrough = require('_stream_passthrough'); +-var Transform = require('_stream_transform'); ++var PassThrough = require('../../').PassThrough; ++var Transform = require('../../').Transform; + + // tiny node-tap lookalike. + var tests = []; +diff --git a/test/simple/test-stream2-unpipe-drain.js b/test/simple/test-stream2-unpipe-drain.js +index d66dc3c..365b327 100644 +--- a/test/simple/test-stream2-unpipe-drain.js ++++ b/test/simple/test-stream2-unpipe-drain.js +@@ -22,7 +22,7 @@ + + var common = require('../common.js'); + var assert = require('assert'); +-var stream = require('stream'); ++var stream = require('../../'); + var crypto = require('crypto'); + + var util = require('util'); +diff --git a/test/simple/test-stream2-unpipe-leak.js b/test/simple/test-stream2-unpipe-leak.js +index 99f8746..17c92ae 100644 +--- a/test/simple/test-stream2-unpipe-leak.js ++++ b/test/simple/test-stream2-unpipe-leak.js +@@ -22,7 +22,7 @@ + + var common = require('../common.js'); + var assert = require('assert'); +-var stream = require('stream'); ++var stream = require('../../'); + + var chunk = new Buffer('hallo'); + +diff --git a/test/simple/test-stream2-writable.js b/test/simple/test-stream2-writable.js +index 704100c..209c3a6 100644 +--- a/test/simple/test-stream2-writable.js ++++ b/test/simple/test-stream2-writable.js +@@ -20,8 +20,8 @@ + // USE OR OTHER DEALINGS IN THE SOFTWARE. + + var common = require('../common.js'); +-var W = require('_stream_writable'); +-var D = require('_stream_duplex'); ++var W = require('../../').Writable; ++var D = require('../../').Duplex; + var assert = require('assert'); + + var util = require('util'); +diff --git a/test/simple/test-stream3-pause-then-read.js b/test/simple/test-stream3-pause-then-read.js +index b91bde3..2f72c15 100644 +--- a/test/simple/test-stream3-pause-then-read.js ++++ b/test/simple/test-stream3-pause-then-read.js +@@ -22,7 +22,7 @@ + var common = require('../common'); + var assert = require('assert'); + +-var stream = require('stream'); ++var stream = require('../../'); + var Readable = stream.Readable; + var Writable = stream.Writable; + diff --git a/nodejs/node_modules/mysql/node_modules/readable-stream/lib/_stream_duplex.js b/nodejs/node_modules/mysql/node_modules/readable-stream/lib/_stream_duplex.js new file mode 100644 index 0000000..b513d61 --- /dev/null +++ b/nodejs/node_modules/mysql/node_modules/readable-stream/lib/_stream_duplex.js @@ -0,0 +1,89 @@ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +// a duplex stream is just a stream that is both readable and writable. +// Since JS doesn't have multiple prototypal inheritance, this class +// prototypally inherits from Readable, and then parasitically from +// Writable. + +module.exports = Duplex; + +/*
+ +#### Top-level + +These are exposed by `require('engine.io')`: + +##### Events + +- `flush` + - Called when a socket buffer is being flushed. + - **Arguments** + - `Socket`: socket being flushed + - `Array`: write buffer +- `drain` + - Called when a socket buffer is drained + - **Arguments** + - `Socket`: socket being flushed + +##### Properties + +- `protocol` _(Number)_: protocol revision number +- `Server`: Server class constructor +- `Socket`: Socket class constructor +- `Transport` _(Function)_: transport constructor +- `transports` _(Object)_: map of available transports + +##### Methods + +- `()` + - Returns a new `Server` instance. If the first argument is an `http.Server` then the + new `Server` instance will be attached to it. Otherwise, the arguments are passed + directly to the `Server` constructor. + - **Parameters** + - `http.Server`: optional, server to attach to. + - `Object`: optional, options object (see `Server#constructor` api docs below) + + The following are identical ways to instantiate a server and then attach it. + ```js + var httpServer; // previously created with `http.createServer();` from node.js api. + + // create a server first, and then attach + var eioServer = require('engine.io').Server(); + eioServer.attach(httpServer); + + // or call the module as a function to get `Server` + var eioServer = require('engine.io')(); + eioServer.attach(httpServer); + + // immediately attach + var eioServer = require('engine.io')(httpServer); + ``` + +- `listen` + - Creates an `http.Server` which listens on the given port and attaches WS + to it. It returns `501 Not Implemented` for regular http requests. + - **Parameters** + - `Number`: port to listen on. + - `Object`: optional, options object + - `Function`: callback for `listen`. + - **Options** + - All options from `Server.attach` method, documented below. + - **Additionally** See Server `constructor` below for options you can pass for creating the new Server + - **Returns** `Server` +- `attach` + - Captures `upgrade` requests for a `http.Server`. In other words, makes + a regular http.Server WebSocket-compatible. + - **Parameters** + - `http.Server`: server to attach to. + - `Object`: optional, options object + - **Options** + - All options from `Server.attach` method, documented below. + - **Additionally** See Server `constructor` below for options you can pass for creating the new Server + - **Returns** `Server` a new Server instance. + +
+ +#### Server + +The main server/manager. _Inherits from EventEmitter_. + +##### Events + +- `connection` + - Fired when a new connection is established. + - **Arguments** + - `Socket`: a Socket object + +##### Properties + +**Important**: if you plan to use Engine.IO in a scalable way, please +keep in mind the properties below will only reflect the clients connected +to a single process. + +- `clients` _(Object)_: hash of connected clients by id. +- `clientsCount` _(Number)_: number of connected clients. + +##### Methods + +- **constructor** + - Initializes the server + - **Parameters** + - `Object`: optional, options object + - **Options** + - `pingTimeout` (`Number`): how many ms without a pong packet to + consider the connection closed (`60000`) + - `pingInterval` (`Number`): how many ms before sending a new ping + packet (`25000`) + - `maxHttpBufferSize` (`Number`): how many bytes or characters a message + can be when polling, before closing the session (to avoid DoS). Default + value is `10E7`. + - `allowRequest` (`Function`): A function that receives a given handshake + or upgrade request as its first parameter, and can decide whether to + continue or not. The second argument is a function that needs to be + called with the decided information: `fn(err, success)`, where + `success` is a boolean value where false means that the request is + rejected, and err is an error code. + - `transports` (`
+ +#### Socket + +A representation of a client. _Inherits from EventEmitter_. + +##### Events + +- `close` + - Fired when the client is disconnected. + - **Arguments** + - `String`: reason for closing + - `Object`: description object (optional) +- `message` + - Fired when the client sends a message. + - **Arguments** + - `String` or `Buffer`: Unicode string or Buffer with binary contents +- `error` + - Fired when an error occurs. + - **Arguments** + - `Error`: error object +- `flush` + - Called when the write buffer is being flushed. + - **Arguments** + - `Array`: write buffer +- `drain` + - Called when the write buffer is drained +- `packet` + - Called when a socket received a packet (`message`, `ping`) + - **Arguments** + - `type`: packet type + - `data`: packet data (if type is message) +- `packetCreate` + - Called before a socket sends a packet (`message`, `pong`) + - **Arguments** + - `type`: packet type + - `data`: packet data (if type is message) + +##### Properties + +- `id` _(String)_: unique identifier +- `server` _(Server)_: engine parent reference +- `request` _(http.ServerRequest)_: request that originated the Socket +- `upgraded` _(Boolean)_: whether the transport has been upgraded +- `readyState` _(String)_: opening|open|closing|closed +- `transport` _(Transport)_: transport reference + +##### Methods + +- `send`: + - Sends a message, performing `message = toString(arguments[0])` unless + sending binary data, which is sent as is. + - **Parameters** + - `String` | `Buffer` | `ArrayBuffer` | `ArrayBufferView`: a string or any object implementing `toString()`, with outgoing data, or a Buffer or ArrayBuffer with binary data. Also any ArrayBufferView can be sent as is. + - `Object`: optional, options object + - `Function`: optional, a callback executed when the message gets flushed out by the transport + - **Options** + - `compress` (`Boolean`): whether to compress sending data. This option might be ignored and forced to be `true` when using polling. (`true`) + - **Returns** `Socket` for chaining +- `close` + - Disconnects the client + - **Returns** `Socket` for chaining + +### Client + +
+ +Exposed in the `eio` global namespace (in the browser), or by +`require('engine.io-client')` (in Node.JS). + +For the client API refer to the +[engine-client](http://github.com/learnboost/engine.io-client) repository. + +## Debug / logging + +Engine.IO is powered by [debug](http://github.com/visionmedia/debug). +In order to see all the debug output, run your app with the environment variable +`DEBUG` including the desired scope. + +To see the output from all of Engine.IO's debugging scopes you can use: + +``` +DEBUG=engine* node myapp +``` + +## Transports + +- `polling`: XHR / JSONP polling transport. +- `websocket`: WebSocket transport. + +## Plugins + +- [engine.io-conflation](https://github.com/EugenDueck/engine.io-conflation): Makes **conflation and aggregation** of messages straightforward. + +## Support + +The support channels for `engine.io` are the same as `socket.io`: + - irc.freenode.net **#socket.io** + - [Google Groups](http://groups.google.com/group/socket_io) + - [Website](http://socket.io) + +## Development + +To contribute patches, run tests or benchmarks, make sure to clone the +repository: + +``` +git clone git://github.com/LearnBoost/engine.io.git +``` + +Then: + +``` +cd engine.io +npm install +``` + +## Tests + +Tests run with `make test`. It runs the server tests that are aided by +the usage of `engine.io-client`. + +Make sure `npm install` is run first. + +## Goals + +The main goal of `Engine` is ensuring the most reliable realtime communication. +Unlike the previous Socket.IO core, it always establishes a long-polling +connection first, then tries to upgrade to better transports that are "tested" on +the side. + +During the lifetime of the Socket.IO projects, we've found countless drawbacks +to relying on `HTML5 WebSocket` or `Flash Socket` as the first connection +mechanisms. + +Both are clearly the _right way_ of establishing a bidirectional communication, +with HTML5 WebSocket being the way of the future. However, to answer most business +needs, alternative traditional HTTP 1.1 mechanisms are just as good as delivering +the same solution. + +WebSocket based connections have two fundamental benefits: + +1. **Better server performance** + - _A: Load balancers_
+ Load balancing a long polling connection poses a serious architectural nightmare + since requests can come from any number of open sockets by the user agent, but + they all need to be routed to the process and computer that owns the `Engine` + connection. This negatively impacts RAM and CPU usage. + - _B: Network traffic_
+ WebSocket is designed around the premise that each message frame has to be + surrounded by the least amount of data. In HTTP 1.1 transports, each message + frame is surrounded by HTTP headers and chunked encoding frames. If you try to + send the message _"Hello world"_ with xhr-polling, the message ultimately + becomes larger than if you were to send it with WebSocket. + - _C: Lightweight parser_
+ As an effect of **B**, the server has to do a lot more work to parse the network + data and figure out the message when traditional HTTP requests are used + (as in long polling). This means that another advantage of WebSocket is + less server CPU usage. + +2. **Better user experience** + + Due to the reasons stated in point **1**, the most important effect of being able + to establish a WebSocket connection is raw data transfer speed, which translates + in _some_ cases in better user experience. + + Applications with heavy realtime interaction (such as games) will benefit greatly, + whereas applications like realtime chat (Gmail/Facebook), newsfeeds (Facebook) or + timelines (Twitter) will have negligible user experience improvements. + +Having said this, attempting to establish a WebSocket connection directly so far has +proven problematic: + +1. **Proxies**
+ Many corporate proxies block WebSocket traffic. + +2. **Personal firewall and antivirus software**
+ As a result of our research, we've found that at least 3 personal security + applications block WebSocket traffic. + +3. **Cloud application platforms**
+ Platforms like Heroku or No.de have had trouble keeping up with the fast-paced + nature of the evolution of the WebSocket protocol. Applications therefore end up + inevitably using long polling, but the seamless installation experience of + Socket.IO we strive for (_"require() it and it just works"_) disappears. + +Some of these problems have solutions. In the case of proxies and personal programs, +however, the solutions many times involve upgrading software. Experience has shown +that relying on client software upgrades to deliver a business solution is +fruitless: the very existence of this project has to do with a fragmented panorama +of user agent distribution, with clients connecting with latest versions of the most +modern user agents (Chrome, Firefox and Safari), but others with versions as low as +IE 5.5. + +From the user perspective, an unsuccessful WebSocket connection can translate in +up to at least 10 seconds of waiting for the realtime application to begin +exchanging data. This **perceptively** hurts user experience. + +To summarize, **Engine** focuses on reliability and user experience first, marginal +potential UX improvements and increased server performance second. `Engine` is the +result of all the lessons learned with WebSocket in the wild. + +## Architecture + +The main premise of `Engine`, and the core of its existence, is the ability to +swap transports on the fly. A connection starts as xhr-polling, but it can +switch to WebSocket. + +The central problem this poses is: how do we switch transports without losing +messages? + +`Engine` only switches from polling to another transport in between polling +cycles. Since the server closes the connection after a certain timeout when +there's no activity, and the polling transport implementation buffers messages +in between connections, this ensures no message loss and optimal performance. + +Another benefit of this design is that we workaround almost all the limitations +of **Flash Socket**, such as slow connection times, increased file size (we can +safely lazy load it without hurting user experience), etc. + +## FAQ + +### Can I use engine without Socket.IO ? + +Absolutely. Although the recommended framework for building realtime applications +is Socket.IO, since it provides fundamental features for real-world applications +such as multiplexing, reconnection support, etc. + +`Engine` is to Socket.IO what Connect is to Express. An essential piece for building +realtime frameworks, but something you _probably_ won't be using for building +actual applications. + +### Does the server serve the client? + +No. The main reason is that `Engine` is meant to be bundled with frameworks. +Socket.IO includes `Engine`, therefore serving two clients is not necessary. If +you use Socket.IO, including + +```html + + ``` + +## Features + +- Runs on browser and node.js seamlessly +- Runs inside HTML5 WebWorker +- Can encode and decode packets + - Encodes from/to ArrayBuffer or Blob when in browser, and Buffer or ArrayBuffer in Node + +## API + +Note: `cb(type)` means the type is a callback function that contains a parameter of type `type` when called. + +### Node + +- `encodePacket` + - Encodes a packet. + - **Parameters** + - `Object`: the packet to encode, has `type` and `data`. + - `data`: can be a `String`, `Number`, `Buffer`, `ArrayBuffer` + - `Boolean`: optional, binary support + - `Function`: callback, returns the encoded packet (`cb(String)`) +- `decodePacket` + - Decodes a packet. Data also available as an ArrayBuffer if requested. + - Returns data as `String` or (`Blob` on browser, `ArrayBuffer` on Node) + - **Parameters** + - `String` | `ArrayBuffer`: the packet to decode, has `type` and `data` + - `String`: optional, the binary type + +- `encodeBase64Packet` + - Encodes a packet with binary data in a base64 string (`String`) + - **Parameters** + - `Object`: the packet to encode, has `type` and `data` + - `Function`: callback, returns the base64 encoded message (`cb(String)`) +- `decodeBase64Packet` + - Decodes a packet encoded in a base64 string. + - **Parameters** + - `String`: the base64 encoded message + - `String`: optional, the binary type + +- `encodePayload` + - Encodes multiple messages (payload). + - If any contents are binary, they will be encoded as base64 strings. Base64 + encoded strings are marked with a b before the length specifier + - **Parameters** + - `Array`: an array of packets + - `Boolean`: optional, binary support + - `Function`: callback, returns the encoded payload (`cb(String)`) +- `decodePayload` + - Decodes data when a payload is maybe expected. Possible binary contents are + decoded from their base64 representation. + - **Parameters** + - `String`: the payload + - `String`: optional, the binary type + - `Function`: callback, returns (cb(`Object`: packet, `Number`:packet index, `Number`:packet total)) + +- `encodePayloadAsBinary` + - Encodes multiple messages (payload) as binary. + - **Parameters** + - `Array`: an array of packets + - `Function`: callback, returns the encoded payload (`cb(Buffer)`) +- `decodePayloadAsBinary` + - Decodes data when a payload is maybe expected. Strings are decoded by + interpreting each byte as a key code for entries marked to start with 0. See + description of encodePayloadAsBinary. + - **Parameters** + - `Buffer`: the buffer + - `String`: optional, the binary type + - `Function`: callback, returns the decoded packet (`cb(Object)`) + +### Browser + +- `encodePayloadAsArrayBuffer` + - Encodes multiple messages (payload) as binary. + - **Parameters** + - `Array`: an array of packets + - `Function`: callback, returns the encoded payload (`cb(ArrayBuffer)`) +- `encodePayloadAsBlob` + - Encodes multiple messages (payload) as blob. + - **Parameters** + - `Array`: an array of packets + - `Function`: callback, returns the encoded payload (`cb(Blob)`) + +## Tests + +Standalone tests can be run with `make test` which will run both node.js and browser tests. + +Browser tests are run using [zuul](https://github.com/defunctzombie/zuul). +(You must have zuul setup with a saucelabs account.) + +You can run the tests locally using the following command: + +``` +./node_modules/.bin/zuul --local 8080 -- test/index.js +``` + +## Support + +The support channels for `engine.io-parser` are the same as `socket.io`: + - irc.freenode.net **#socket.io** + - [Google Groups](http://groups.google.com/group/socket_io) + - [Website](http://socket.io) + +## Development + +To contribute patches, run tests or benchmarks, make sure to clone the +repository: + +```bash +git clone git://github.com/LearnBoost/engine.io-parser.git +``` + +Then: + +```bash +cd engine.io-parser +npm install +``` + +See the `Tests` section above for how to run tests before submitting any patches. + +## License + +MIT diff --git a/nodejs/node_modules/socket.io/node_modules/engine.io/node_modules/engine.io-parser/index.js b/nodejs/node_modules/socket.io/node_modules/engine.io/node_modules/engine.io-parser/index.js new file mode 100644 index 0000000..887727f --- /dev/null +++ b/nodejs/node_modules/socket.io/node_modules/engine.io/node_modules/engine.io-parser/index.js @@ -0,0 +1,2 @@ + +module.exports = require('./lib/'); diff --git a/nodejs/node_modules/socket.io/node_modules/engine.io/node_modules/engine.io-parser/lib/browser.js b/nodejs/node_modules/socket.io/node_modules/engine.io/node_modules/engine.io-parser/lib/browser.js new file mode 100644 index 0000000..8dc26cd --- /dev/null +++ b/nodejs/node_modules/socket.io/node_modules/engine.io/node_modules/engine.io-parser/lib/browser.js @@ -0,0 +1,594 @@ +/** + * Module dependencies. + */ + +var keys = require('./keys'); +var hasBinary = require('has-binary'); +var sliceBuffer = require('arraybuffer.slice'); +var base64encoder = require('base64-arraybuffer'); +var after = require('after'); +var utf8 = require('utf8'); + +/** + * Check if we are running an android browser. That requires us to use + * ArrayBuffer with polling transports... + * + * http://ghinda.net/jpeg-blob-ajax-android/ + */ + +var isAndroid = navigator.userAgent.match(/Android/i); + +/** + * Check if we are running in PhantomJS. + * Uploading a Blob with PhantomJS does not work correctly, as reported here: + * https://github.com/ariya/phantomjs/issues/11395 + * @type boolean + */ +var isPhantomJS = /PhantomJS/i.test(navigator.userAgent); + +/** + * When true, avoids using Blobs to encode payloads. + * @type boolean + */ +var dontSendBlobs = isAndroid || isPhantomJS; + +/** + * Current protocol version. + */ + +exports.protocol = 3; + +/** + * Packet types. + */ + +var packets = exports.packets = { + open: 0 // non-ws + , close: 1 // non-ws + , ping: 2 + , pong: 3 + , message: 4 + , upgrade: 5 + , noop: 6 +}; + +var packetslist = keys(packets); + +/** + * Premade error packet. + */ + +var err = { type: 'error', data: 'parser error' }; + +/** + * Create a blob api even for blob builder when vendor prefixes exist + */ + +var Blob = require('blob'); + +/** + * Encodes a packet. + * + *
\n\n#### Top-level\n\nThese are exposed by `require('engine.io')`:\n\n##### Events\n\n- `flush`\n - Called when a socket buffer is being flushed.\n - **Arguments**\n - `Socket`: socket being flushed\n - `Array`: write buffer\n- `drain`\n - Called when a socket buffer is drained\n - **Arguments**\n - `Socket`: socket being flushed\n\n##### Properties\n\n- `protocol` _(Number)_: protocol revision number\n- `Server`: Server class constructor\n- `Socket`: Socket class constructor\n- `Transport` _(Function)_: transport constructor\n- `transports` _(Object)_: map of available transports\n\n##### Methods\n\n- `()`\n - Returns a new `Server` instance. If the first argument is an `http.Server` then the\n new `Server` instance will be attached to it. Otherwise, the arguments are passed\n directly to the `Server` constructor.\n - **Parameters**\n - `http.Server`: optional, server to attach to.\n - `Object`: optional, options object (see `Server#constructor` api docs below)\n\n The following are identical ways to instantiate a server and then attach it.\n ```js\n var httpServer; // previously created with `http.createServer();` from node.js api.\n\n // create a server first, and then attach\n var eioServer = require('engine.io').Server();\n eioServer.attach(httpServer);\n\n // or call the module as a function to get `Server`\n var eioServer = require('engine.io')();\n eioServer.attach(httpServer);\n\n // immediately attach\n var eioServer = require('engine.io')(httpServer);\n ```\n\n- `listen`\n - Creates an `http.Server` which listens on the given port and attaches WS\n to it. It returns `501 Not Implemented` for regular http requests.\n - **Parameters**\n - `Number`: port to listen on.\n - `Object`: optional, options object\n - `Function`: callback for `listen`.\n - **Options**\n - All options from `Server.attach` method, documented below.\n - **Additionally** See Server `constructor` below for options you can pass for creating the new Server\n - **Returns** `Server`\n- `attach`\n - Captures `upgrade` requests for a `http.Server`. In other words, makes\n a regular http.Server WebSocket-compatible.\n - **Parameters**\n - `http.Server`: server to attach to.\n - `Object`: optional, options object\n - **Options**\n - All options from `Server.attach` method, documented below.\n - **Additionally** See Server `constructor` below for options you can pass for creating the new Server\n - **Returns** `Server` a new Server instance.\n\n
\n\n#### Server\n\nThe main server/manager. _Inherits from EventEmitter_.\n\n##### Events\n\n- `connection`\n - Fired when a new connection is established.\n - **Arguments**\n - `Socket`: a Socket object\n\n##### Properties\n\n**Important**: if you plan to use Engine.IO in a scalable way, please\nkeep in mind the properties below will only reflect the clients connected\nto a single process.\n\n- `clients` _(Object)_: hash of connected clients by id.\n- `clientsCount` _(Number)_: number of connected clients.\n\n##### Methods\n\n- **constructor**\n - Initializes the server\n - **Parameters**\n - `Object`: optional, options object\n - **Options**\n - `pingTimeout` (`Number`): how many ms without a pong packet to\n consider the connection closed (`60000`)\n - `pingInterval` (`Number`): how many ms before sending a new ping\n packet (`25000`)\n - `maxHttpBufferSize` (`Number`): how many bytes or characters a message\n can be when polling, before closing the session (to avoid DoS). Default\n value is `10E7`.\n - `allowRequest` (`Function`): A function that receives a given handshake\n or upgrade request as its first parameter, and can decide whether to\n continue or not. The second argument is a function that needs to be\n called with the decided information: `fn(err, success)`, where\n `success` is a boolean value where false means that the request is\n rejected, and err is an error code.\n - `transports` (`
\n\n#### Socket\n\nA representation of a client. _Inherits from EventEmitter_.\n\n##### Events\n\n- `close`\n - Fired when the client is disconnected.\n - **Arguments**\n - `String`: reason for closing\n - `Object`: description object (optional)\n- `message`\n - Fired when the client sends a message.\n - **Arguments**\n - `String` or `Buffer`: Unicode string or Buffer with binary contents\n- `error`\n - Fired when an error occurs.\n - **Arguments**\n - `Error`: error object\n- `flush`\n - Called when the write buffer is being flushed.\n - **Arguments**\n - `Array`: write buffer\n- `drain`\n - Called when the write buffer is drained\n- `packet`\n - Called when a socket received a packet (`message`, `ping`)\n - **Arguments**\n - `type`: packet type\n - `data`: packet data (if type is message)\n- `packetCreate`\n - Called before a socket sends a packet (`message`, `pong`)\n - **Arguments**\n - `type`: packet type\n - `data`: packet data (if type is message)\n\n##### Properties\n\n- `id` _(String)_: unique identifier\n- `server` _(Server)_: engine parent reference\n- `request` _(http.ServerRequest)_: request that originated the Socket\n- `upgraded` _(Boolean)_: whether the transport has been upgraded\n- `readyState` _(String)_: opening|open|closing|closed\n- `transport` _(Transport)_: transport reference\n\n##### Methods\n\n- `send`:\n - Sends a message, performing `message = toString(arguments[0])` unless\n sending binary data, which is sent as is.\n - **Parameters**\n - `String` | `Buffer` | `ArrayBuffer` | `ArrayBufferView`: a string or any object implementing `toString()`, with outgoing data, or a Buffer or ArrayBuffer with binary data. Also any ArrayBufferView can be sent as is.\n - `Object`: optional, options object\n - `Function`: optional, a callback executed when the message gets flushed out by the transport\n - **Options**\n - `compress` (`Boolean`): whether to compress sending data. This option might be ignored and forced to be `true` when using polling. (`true`)\n - **Returns** `Socket` for chaining\n- `close`\n - Disconnects the client\n - **Returns** `Socket` for chaining\n\n### Client\n\n
\n\nExposed in the `eio` global namespace (in the browser), or by\n`require('engine.io-client')` (in Node.JS).\n\nFor the client API refer to the\n[engine-client](http://github.com/learnboost/engine.io-client) repository.\n\n## Debug / logging\n\nEngine.IO is powered by [debug](http://github.com/visionmedia/debug).\nIn order to see all the debug output, run your app with the environment variable\n`DEBUG` including the desired scope.\n\nTo see the output from all of Engine.IO's debugging scopes you can use:\n\n```\nDEBUG=engine* node myapp\n```\n\n## Transports\n\n- `polling`: XHR / JSONP polling transport.\n- `websocket`: WebSocket transport.\n\n## Plugins\n\n- [engine.io-conflation](https://github.com/EugenDueck/engine.io-conflation): Makes **conflation and aggregation** of messages straightforward.\n\n## Support\n\nThe support channels for `engine.io` are the same as `socket.io`:\n - irc.freenode.net **#socket.io**\n - [Google Groups](http://groups.google.com/group/socket_io)\n - [Website](http://socket.io)\n\n## Development\n\nTo contribute patches, run tests or benchmarks, make sure to clone the\nrepository:\n\n```\ngit clone git://github.com/LearnBoost/engine.io.git\n```\n\nThen:\n\n```\ncd engine.io\nnpm install\n```\n\n## Tests\n\nTests run with `make test`. It runs the server tests that are aided by\nthe usage of `engine.io-client`.\n\nMake sure `npm install` is run first.\n\n## Goals\n\nThe main goal of `Engine` is ensuring the most reliable realtime communication.\nUnlike the previous Socket.IO core, it always establishes a long-polling\nconnection first, then tries to upgrade to better transports that are \"tested\" on\nthe side.\n\nDuring the lifetime of the Socket.IO projects, we've found countless drawbacks\nto relying on `HTML5 WebSocket` or `Flash Socket` as the first connection\nmechanisms.\n\nBoth are clearly the _right way_ of establishing a bidirectional communication,\nwith HTML5 WebSocket being the way of the future. However, to answer most business\nneeds, alternative traditional HTTP 1.1 mechanisms are just as good as delivering\nthe same solution.\n\nWebSocket based connections have two fundamental benefits:\n\n1. **Better server performance**\n - _A: Load balancers_
\n Load balancing a long polling connection poses a serious architectural nightmare\n since requests can come from any number of open sockets by the user agent, but\n they all need to be routed to the process and computer that owns the `Engine`\n connection. This negatively impacts RAM and CPU usage.\n - _B: Network traffic_
\n WebSocket is designed around the premise that each message frame has to be\n surrounded by the least amount of data. In HTTP 1.1 transports, each message\n frame is surrounded by HTTP headers and chunked encoding frames. If you try to\n send the message _\"Hello world\"_ with xhr-polling, the message ultimately\n becomes larger than if you were to send it with WebSocket.\n - _C: Lightweight parser_
\n As an effect of **B**, the server has to do a lot more work to parse the network\n data and figure out the message when traditional HTTP requests are used\n (as in long polling). This means that another advantage of WebSocket is\n less server CPU usage.\n\n2. **Better user experience**\n\n Due to the reasons stated in point **1**, the most important effect of being able\n to establish a WebSocket connection is raw data transfer speed, which translates\n in _some_ cases in better user experience.\n\n Applications with heavy realtime interaction (such as games) will benefit greatly,\n whereas applications like realtime chat (Gmail/Facebook), newsfeeds (Facebook) or\n timelines (Twitter) will have negligible user experience improvements.\n\nHaving said this, attempting to establish a WebSocket connection directly so far has\nproven problematic:\n\n1. **Proxies**
\n Many corporate proxies block WebSocket traffic.\n\n2. **Personal firewall and antivirus software**
\n As a result of our research, we've found that at least 3 personal security\n applications block WebSocket traffic.\n\n3. **Cloud application platforms**
\n Platforms like Heroku or No.de have had trouble keeping up with the fast-paced\n nature of the evolution of the WebSocket protocol. Applications therefore end up\n inevitably using long polling, but the seamless installation experience of\n Socket.IO we strive for (_\"require() it and it just works\"_) disappears.\n\nSome of these problems have solutions. In the case of proxies and personal programs,\nhowever, the solutions many times involve upgrading software. Experience has shown\nthat relying on client software upgrades to deliver a business solution is\nfruitless: the very existence of this project has to do with a fragmented panorama\nof user agent distribution, with clients connecting with latest versions of the most\nmodern user agents (Chrome, Firefox and Safari), but others with versions as low as\nIE 5.5.\n\nFrom the user perspective, an unsuccessful WebSocket connection can translate in\nup to at least 10 seconds of waiting for the realtime application to begin\nexchanging data. This **perceptively** hurts user experience.\n\nTo summarize, **Engine** focuses on reliability and user experience first, marginal\npotential UX improvements and increased server performance second. `Engine` is the\nresult of all the lessons learned with WebSocket in the wild.\n\n## Architecture\n\nThe main premise of `Engine`, and the core of its existence, is the ability to\nswap transports on the fly. A connection starts as xhr-polling, but it can\nswitch to WebSocket.\n\nThe central problem this poses is: how do we switch transports without losing\nmessages?\n\n`Engine` only switches from polling to another transport in between polling\ncycles. Since the server closes the connection after a certain timeout when\nthere's no activity, and the polling transport implementation buffers messages\nin between connections, this ensures no message loss and optimal performance.\n\nAnother benefit of this design is that we workaround almost all the limitations\nof **Flash Socket**, such as slow connection times, increased file size (we can\nsafely lazy load it without hurting user experience), etc.\n\n## FAQ\n\n### Can I use engine without Socket.IO ?\n\nAbsolutely. Although the recommended framework for building realtime applications\nis Socket.IO, since it provides fundamental features for real-world applications\nsuch as multiplexing, reconnection support, etc.\n\n`Engine` is to Socket.IO what Connect is to Express. An essential piece for building\nrealtime frameworks, but something you _probably_ won't be using for building\nactual applications.\n\n### Does the server serve the client?\n\nNo. The main reason is that `Engine` is meant to be bundled with frameworks.\nSocket.IO includes `Engine`, therefore serving two clients is not necessary. If\nyou use Socket.IO, including\n\n```html\n +~~~ + +Optionally, expose Java’s nanosecond timer by adding the `nano` applet to the ``: + +~~~ html + +~~~ + +Or enable Chrome’s microsecond timer by using the [command line switch](http://peter.sh/experiments/chromium-command-line-switches/#enable-benchmarking): + + --enable-benchmarking + +Via [npm](http://npmjs.org/): + +~~~ bash +npm install benchmark +~~~ + +In [Node.js](http://nodejs.org/) and [RingoJS v0.8.0+](http://ringojs.org/): + +~~~ js +var Benchmark = require('benchmark'); +~~~ + +Optionally, use the [microtime module](https://github.com/wadey/node-microtime) by Wade Simmons: + +~~~ bash +npm install microtime +~~~ + +In [RingoJS v0.7.0-](http://ringojs.org/): + +~~~ js +var Benchmark = require('benchmark').Benchmark; +~~~ + +In [Rhino](http://www.mozilla.org/rhino/): + +~~~ js +load('benchmark.js'); +~~~ + +In an AMD loader like [RequireJS](http://requirejs.org/): + +~~~ js +require({ + 'paths': { + 'benchmark': 'path/to/benchmark' + } +}, +['benchmark'], function(Benchmark) { + console.log(Benchmark.version); +}); + +// or with platform.js +// https://github.com/bestiejs/platform.js +require({ + 'paths': { + 'benchmark': 'path/to/benchmark', + 'platform': 'path/to/platform' + } +}, +['benchmark', 'platform'], function(Benchmark, platform) { + Benchmark.platform = platform; + console.log(Benchmark.platform.name); +}); +~~~ + +Usage example: + +~~~ js +var suite = new Benchmark.Suite; + +// add tests +suite.add('RegExp#test', function() { + /o/.test('Hello World!'); +}) +.add('String#indexOf', function() { + 'Hello World!'.indexOf('o') > -1; +}) +// add listeners +.on('cycle', function(event) { + console.log(String(event.target)); +}) +.on('complete', function() { + console.log('Fastest is ' + this.filter('fastest').pluck('name')); +}) +// run async +.run({ 'async': true }); + +// logs: +// > RegExp#test x 4,161,532 +-0.99% (59 cycles) +// > String#indexOf x 6,139,623 +-1.00% (131 cycles) +// > Fastest is String#indexOf +~~~ + +## Authors + +* [Mathias Bynens](http://mathiasbynens.be/) + [](https://twitter.com/mathias "Follow @mathias on Twitter") +* [John-David Dalton](http://allyoucanleet.com/) + [](https://twitter.com/jdalton "Follow @jdalton on Twitter") + +## Contributors + +* [Kit Cambridge](http://kitcambridge.github.com/) + [](https://twitter.com/kitcambridge "Follow @kitcambridge on Twitter") diff --git a/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/benchmark/benchmark.js b/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/benchmark/benchmark.js new file mode 100644 index 0000000..d8eb309 --- /dev/null +++ b/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/benchmark/benchmark.js @@ -0,0 +1,3918 @@ +/*! + * Benchmark.js v1.0.0
+
+Code coverage report for lib/json3.js
++ + Statements: 13.77% (50 / 363) + + + Branches: 15.32% (59 / 385) + + + Functions: 11.54% (3 / 26) + + + Lines: 13.77% (50 / 363) + +
+ +
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/json3/coverage/lcov-report/prettify.css b/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/json3/coverage/lcov-report/prettify.css
new file mode 100644
index 0000000..b317a7c
--- /dev/null
+++ b/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/json3/coverage/lcov-report/prettify.css
@@ -0,0 +1 @@
+.pln{color:#000}@media screen{.str{color:#080}.kwd{color:#008}.com{color:#800}.typ{color:#606}.lit{color:#066}.pun,.opn,.clo{color:#660}.tag{color:#008}.atn{color:#606}.atv{color:#080}.dec,.var{color:#606}.fun{color:red}}@media print,projection{.str{color:#060}.kwd{color:#006;font-weight:bold}.com{color:#600;font-style:italic}.typ{color:#404;font-weight:bold}.lit{color:#044}.pun,.opn,.clo{color:#440}.tag{color:#006;font-weight:bold}.atn{color:#404}.atv{color:#060}}pre.prettyprint{padding:2px;border:1px solid #888}ol.linenums{margin-top:0;margin-bottom:0}li.L0,li.L1,li.L2,li.L3,li.L5,li.L6,li.L7,li.L8{list-style-type:none}li.L1,li.L3,li.L5,li.L7,li.L9{background:#eee}
diff --git a/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/json3/coverage/lcov-report/prettify.js b/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/json3/coverage/lcov-report/prettify.js
new file mode 100644
index 0000000..ef51e03
--- /dev/null
+++ b/nodejs/node_modules/socket.io/node_modules/socket.io-adapter/node_modules/socket.io-parser/node_modules/json3/coverage/lcov-report/prettify.js
@@ -0,0 +1 @@
+window.PR_SHOULD_USE_CONTINUATION=true;(function(){var h=["break,continue,do,else,for,if,return,while"];var u=[h,"auto,case,char,const,default,double,enum,extern,float,goto,int,long,register,short,signed,sizeof,static,struct,switch,typedef,union,unsigned,void,volatile"];var p=[u,"catch,class,delete,false,import,new,operator,private,protected,public,this,throw,true,try,typeof"];var l=[p,"alignof,align_union,asm,axiom,bool,concept,concept_map,const_cast,constexpr,decltype,dynamic_cast,explicit,export,friend,inline,late_check,mutable,namespace,nullptr,reinterpret_cast,static_assert,static_cast,template,typeid,typename,using,virtual,where"];var x=[p,"abstract,boolean,byte,extends,final,finally,implements,import,instanceof,null,native,package,strictfp,super,synchronized,throws,transient"];var R=[x,"as,base,by,checked,decimal,delegate,descending,dynamic,event,fixed,foreach,from,group,implicit,in,interface,internal,into,is,lock,object,out,override,orderby,params,partial,readonly,ref,sbyte,sealed,stackalloc,string,select,uint,ulong,unchecked,unsafe,ushort,var"];var r="all,and,by,catch,class,else,extends,false,finally,for,if,in,is,isnt,loop,new,no,not,null,of,off,on,or,return,super,then,true,try,unless,until,when,while,yes";var w=[p,"debugger,eval,export,function,get,null,set,undefined,var,with,Infinity,NaN"];var s="caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END";var I=[h,"and,as,assert,class,def,del,elif,except,exec,finally,from,global,import,in,is,lambda,nonlocal,not,or,pass,print,raise,try,with,yield,False,True,None"];var f=[h,"alias,and,begin,case,class,def,defined,elsif,end,ensure,false,in,module,next,nil,not,or,redo,rescue,retry,self,super,then,true,undef,unless,until,when,yield,BEGIN,END"];var H=[h,"case,done,elif,esac,eval,fi,function,in,local,set,then,until"];var A=[l,R,w,s+I,f,H];var e=/^(DIR|FILE|vector|(de|priority_)?queue|list|stack|(const_)?iterator|(multi)?(set|map)|bitset|u?(int|float)\d*)/;var C="str";var z="kwd";var j="com";var O="typ";var G="lit";var L="pun";var F="pln";var m="tag";var E="dec";var J="src";var P="atn";var n="atv";var N="nocode";var M="(?:^^\\.?|[+-]|\\!|\\!=|\\!==|\\#|\\%|\\%=|&|&&|&&=|&=|\\(|\\*|\\*=|\\+=|\\,|\\-=|\\->|\\/|\\/=|:|::|\\;|<|<<|<<=|<=|=|==|===|>|>=|>>|>>=|>>>|>>>=|\\?|\\@|\\[|\\^|\\^=|\\^\\^|\\^\\^=|\\{|\\||\\|=|\\|\\||\\|\\|=|\\~|break|case|continue|delete|do|else|finally|instanceof|return|throw|try|typeof)\\s*";function k(Z){var ad=0;var S=false;var ac=false;for(var V=0,U=Z.length;V| 1 +2 +3 +4 +5 +6 +7 +8 +9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 +90 +91 +92 +93 +94 +95 +96 +97 +98 +99 +100 +101 +102 +103 +104 +105 +106 +107 +108 +109 +110 +111 +112 +113 +114 +115 +116 +117 +118 +119 +120 +121 +122 +123 +124 +125 +126 +127 +128 +129 +130 +131 +132 +133 +134 +135 +136 +137 +138 +139 +140 +141 +142 +143 +144 +145 +146 +147 +148 +149 +150 +151 +152 +153 +154 +155 +156 +157 +158 +159 +160 +161 +162 +163 +164 +165 +166 +167 +168 +169 +170 +171 +172 +173 +174 +175 +176 +177 +178 +179 +180 +181 +182 +183 +184 +185 +186 +187 +188 +189 +190 +191 +192 +193 +194 +195 +196 +197 +198 +199 +200 +201 +202 +203 +204 +205 +206 +207 +208 +209 +210 +211 +212 +213 +214 +215 +216 +217 +218 +219 +220 +221 +222 +223 +224 +225 +226 +227 +228 +229 +230 +231 +232 +233 +234 +235 +236 +237 +238 +239 +240 +241 +242 +243 +244 +245 +246 +247 +248 +249 +250 +251 +252 +253 +254 +255 +256 +257 +258 +259 +260 +261 +262 +263 +264 +265 +266 +267 +268 +269 +270 +271 +272 +273 +274 +275 +276 +277 +278 +279 +280 +281 +282 +283 +284 +285 +286 +287 +288 +289 +290 +291 +292 +293 +294 +295 +296 +297 +298 +299 +300 +301 +302 +303 +304 +305 +306 +307 +308 +309 +310 +311 +312 +313 +314 +315 +316 +317 +318 +319 +320 +321 +322 +323 +324 +325 +326 +327 +328 +329 +330 +331 +332 +333 +334 +335 +336 +337 +338 +339 +340 +341 +342 +343 +344 +345 +346 +347 +348 +349 +350 +351 +352 +353 +354 +355 +356 +357 +358 +359 +360 +361 +362 +363 +364 +365 +366 +367 +368 +369 +370 +371 +372 +373 +374 +375 +376 +377 +378 +379 +380 +381 +382 +383 +384 +385 +386 +387 +388 +389 +390 +391 +392 +393 +394 +395 +396 +397 +398 +399 +400 +401 +402 +403 +404 +405 +406 +407 +408 +409 +410 +411 +412 +413 +414 +415 +416 +417 +418 +419 +420 +421 +422 +423 +424 +425 +426 +427 +428 +429 +430 +431 +432 +433 +434 +435 +436 +437 +438 +439 +440 +441 +442 +443 +444 +445 +446 +447 +448 +449 +450 +451 +452 +453 +454 +455 +456 +457 +458 +459 +460 +461 +462 +463 +464 +465 +466 +467 +468 +469 +470 +471 +472 +473 +474 +475 +476 +477 +478 +479 +480 +481 +482 +483 +484 +485 +486 +487 +488 +489 +490 +491 +492 +493 +494 +495 +496 +497 +498 +499 +500 +501 +502 +503 +504 +505 +506 +507 +508 +509 +510 +511 +512 +513 +514 +515 +516 +517 +518 +519 +520 +521 +522 +523 +524 +525 +526 +527 +528 +529 +530 +531 +532 +533 +534 +535 +536 +537 +538 +539 +540 +541 +542 +543 +544 +545 +546 +547 +548 +549 +550 +551 +552 +553 +554 +555 +556 +557 +558 +559 +560 +561 +562 +563 +564 +565 +566 +567 +568 +569 +570 +571 +572 +573 +574 +575 +576 +577 +578 +579 +580 +581 +582 +583 +584 +585 +586 +587 +588 +589 +590 +591 +592 +593 +594 +595 +596 +597 +598 +599 +600 +601 +602 +603 +604 +605 +606 +607 +608 +609 +610 +611 +612 +613 +614 +615 +616 +617 +618 +619 +620 +621 +622 +623 +624 +625 +626 +627 +628 +629 +630 +631 +632 +633 +634 +635 +636 +637 +638 +639 +640 +641 +642 +643 +644 +645 +646 +647 +648 +649 +650 +651 +652 +653 +654 +655 +656 +657 +658 +659 +660 +661 +662 +663 +664 +665 +666 +667 +668 +669 +670 +671 +672 +673 +674 +675 +676 +677 +678 +679 +680 +681 +682 +683 +684 +685 +686 +687 +688 +689 +690 +691 +692 +693 +694 +695 +696 +697 +698 +699 +700 +701 +702 +703 +704 +705 +706 +707 +708 +709 +710 +711 +712 +713 +714 +715 +716 +717 +718 +719 +720 +721 +722 +723 +724 +725 +726 +727 +728 +729 +730 +731 +732 +733 +734 +735 +736 +737 +738 +739 +740 +741 +742 +743 +744 +745 +746 +747 +748 +749 +750 +751 +752 +753 +754 +755 +756 +757 +758 +759 +760 +761 +762 +763 +764 +765 +766 +767 +768 +769 +770 +771 +772 +773 +774 +775 +776 +777 +778 +779 +780 +781 +782 +783 +784 +785 +786 +787 +788 +789 +790 +791 +792 +793 +794 +795 +796 +797 +798 +799 +800 +801 +802 +803 +804 +805 +806 +807 +808 +809 +810 +811 +812 +813 +814 +815 +816 +817 +818 +819 +820 +821 +822 +823 +824 +825 +826 +827 +828 +829 +830 +831 +832 +833 +834 +835 +836 +837 +838 +839 +840 +841 +842 +843 +844 +845 +846 +847 +848 +849 +850 +851 +852 +853 +854 +855 +856 +857 +858 +859 +860 +861 +862 +863 +864 +865 +866 +867 | +1 + +1 + + + +1 + + +1 + + + +1 + +1 + + +1 +1 + + + + + + + +1 +1 + + +1 + + + + + + + + +1 +3 + + + + +3 +3 + + + +3 + + +1 + +2 + +2 +1 +1 + +1 +4 + +1 +1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +1 + + +2 +1 +1 +1 + + + +1 + +1 +1 +1 +1 + +1 + +1 +1 + + + +1 + + +1 +1 + + + +1 + + + + + + + + +1 + + +3 + +1 +1 +1 +1 + +1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +1 + + + + + + | /*! JSON v3.2.5 | http://bestiejs.github.io/json3 | Copyright 2012-2013, Kit Cambridge | http://kit.mit-license.org */
+;(function (window) {
+ // Convenience aliases.
+ var getClass = {}.toString, isProperty, forEach, undef;
+
+ // Detect the `define` function exposed by asynchronous module loaders. The
+ // strict `define` check is necessary for compatibility with `r.js`.
+ var isLoader = typeof define === "function" && define.amd;
+
+ // Detect native implementations.
+ var nativeJSON = typeof JSON == "object" && JSON;
+
+ // Set up the JSON 3 namespace, preferring the CommonJS `exports` object if
+ // available.
+ var JSON3 = typeof exports == "object" && exports && !exports.nodeType && exports;
+
+ Eif (JSON3 && nativeJSON) {
+ // Explicitly delegate to the native `stringify` and `parse`
+ // implementations in CommonJS environments.
+ JSON3.stringify = nativeJSON.stringify;
+ JSON3.parse = nativeJSON.parse;
+ } else {
+ // Export for web browsers, JavaScript engines, and asynchronous module
+ // loaders, using the global `JSON` object if available.
+ JSON3 = window.JSON = nativeJSON || {};
+ }
+
+ // Test the `Date#getUTC*` methods. Based on work by @Yaffle.
+ var isExtended = new Date(-3509827334573292);
+ try {
+ // The `getUTCFullYear`, `Month`, and `Date` methods return nonsensical
+ // results for certain dates in Opera >= 10.53.
+ isExtended = isExtended.getUTCFullYear() == -109252 && isExtended.getUTCMonth() === 0 && isExtended.getUTCDate() === 1 &&
+ // Safari < 2.0.2 stores the internal millisecond time value correctly,
+ // but clips the values returned by the date methods to the range of
+ // signed 32-bit integers ([-2 ** 31, 2 ** 31 - 1]).
+ isExtended.getUTCHours() == 10 && isExtended.getUTCMinutes() == 37 && isExtended.getUTCSeconds() == 6 && isExtended.getUTCMilliseconds() == 708;
+ } catch (exception) {}
+
+ // Internal: Determines whether the native `JSON.stringify` and `parse`
+ // implementations are spec-compliant. Based on work by Ken Snyder.
+ function has(name) {
+ Iif (has[name] != null) {
+ // Return cached feature test result.
+ return has[name];
+ }
+
+ var isSupported;
+ Iif (name == "bug-string-char-index") {
+ // IE <= 7 doesn't support accessing string characters using square
+ // bracket notation. IE 8 only supports this for primitives.
+ isSupported = "a"[0] != "a";
+ } else if (name == "json") {
+ // Indicates whether both `JSON.stringify` and `JSON.parse` are
+ // supported.
+ isSupported = has("json-stringify") && has("json-parse");
+ } else {
+ var value, serialized = '{"a":[1,true,false,null,"\\u0000\\b\\n\\f\\r\\t"]}';
+ // Test `JSON.stringify`.
+ if (name == "json-stringify") {
+ var stringify = JSON3.stringify, stringifySupported = typeof stringify == "function" && isExtended;
+ Eif (stringifySupported) {
+ // A test function object with a custom `toJSON` method.
+ (value = function () {
+ return 1;
+ }).toJSON = value;
+ try {
+ stringifySupported =
+ // Firefox 3.1b1 and b2 serialize string, number, and boolean
+ // primitives as object literals.
+ stringify(0) === "0" &&
+ // FF 3.1b1, b2, and JSON 2 serialize wrapped primitives as object
+ // literals.
+ stringify(new Number()) === "0" &&
+ stringify(new String()) == '""' &&
+ // FF 3.1b1, 2 throw an error if the value is `null`, `undefined`, or
+ // does not define a canonical JSON representation (this applies to
+ // objects with `toJSON` properties as well, *unless* they are nested
+ // within an object or array).
+ stringify(getClass) === undef &&
+ // IE 8 serializes `undefined` as `"undefined"`. Safari <= 5.1.7 and
+ // FF 3.1b3 pass this test.
+ stringify(undef) === undef &&
+ // Safari <= 5.1.7 and FF 3.1b3 throw `Error`s and `TypeError`s,
+ // respectively, if the value is omitted entirely.
+ stringify() === undef &&
+ // FF 3.1b1, 2 throw an error if the given value is not a number,
+ // string, array, object, Boolean, or `null` literal. This applies to
+ // objects with custom `toJSON` methods as well, unless they are nested
+ // inside object or array literals. YUI 3.0.0b1 ignores custom `toJSON`
+ // methods entirely.
+ stringify(value) === "1" &&
+ stringify([value]) == "[1]" &&
+ // Prototype <= 1.6.1 serializes `[undefined]` as `"[]"` instead of
+ // `"[null]"`.
+ stringify([undef]) == "[null]" &&
+ // YUI 3.0.0b1 fails to serialize `null` literals.
+ stringify(null) == "null" &&
+ // FF 3.1b1, 2 halts serialization if an array contains a function:
+ // `[1, true, getClass, 1]` serializes as "[1,true,],". FF 3.1b3
+ // elides non-JSON values from objects and arrays, unless they
+ // define custom `toJSON` methods.
+ stringify([undef, getClass, null]) == "[null,null,null]" &&
+ // Simple serialization test. FF 3.1b1 uses Unicode escape sequences
+ // where character escape codes are expected (e.g., `\b` => `\u0008`).
+ stringify({ "a": [value, true, false, null, "\x00\b\n\f\r\t"] }) == serialized &&
+ // FF 3.1b1 and b2 ignore the `filter` and `width` arguments.
+ stringify(null, value) === "1" &&
+ stringify([1, 2], null, 1) == "[\n 1,\n 2\n]" &&
+ // JSON 2, Prototype <= 1.7, and older WebKit builds incorrectly
+ // serialize extended years.
+ stringify(new Date(-8.64e15)) == '"-271821-04-20T00:00:00.000Z"' &&
+ // The milliseconds are optional in ES 5, but required in 5.1.
+ stringify(new Date(8.64e15)) == '"+275760-09-13T00:00:00.000Z"' &&
+ // Firefox <= 11.0 incorrectly serializes years prior to 0 as negative
+ // four-digit years instead of six-digit years. Credits: @Yaffle.
+ stringify(new Date(-621987552e5)) == '"-000001-01-01T00:00:00.000Z"' &&
+ // Safari <= 5.1.5 and Opera >= 10.53 incorrectly serialize millisecond
+ // values less than 1000. Credits: @Yaffle.
+ stringify(new Date(-1)) == '"1969-12-31T23:59:59.999Z"';
+ } catch (exception) {
+ stringifySupported = false;
+ }
+ }
+ isSupported = stringifySupported;
+ }
+ // Test `JSON.parse`.
+ if (name == "json-parse") {
+ var parse = JSON3.parse;
+ Eif (typeof parse == "function") {
+ try {
+ // FF 3.1b1, b2 will throw an exception if a bare literal is provided.
+ // Conforming implementations should also coerce the initial argument to
+ // a string prior to parsing.
+ Eif (parse("0") === 0 && !parse(false)) {
+ // Simple parsing test.
+ value = parse(serialized);
+ var parseSupported = value["a"].length == 5 && value["a"][0] === 1;
+ Eif (parseSupported) {
+ try {
+ // Safari <= 5.1.2 and FF 3.1b1 allow unescaped tabs in strings.
+ parseSupported = !parse('"\t"');
+ } catch (exception) {}
+ Eif (parseSupported) {
+ try {
+ // FF 4.0 and 4.0.1 allow leading `+` signs and leading
+ // decimal points. FF 4.0, 4.0.1, and IE 9-10 also allow
+ // certain octal literals.
+ parseSupported = parse("01") !== 1;
+ } catch (exception) {}
+ }
+ Eif (parseSupported) {
+ try {
+ // FF 4.0, 4.0.1, and Rhino 1.7R3-R4 allow trailing decimal
+ // points. These environments, along with FF 3.1b1 and 2,
+ // also allow trailing commas in JSON objects and arrays.
+ parseSupported = parse("1.") !== 1;
+ } catch (exception) {}
+ }
+ }
+ }
+ } catch (exception) {
+ parseSupported = false;
+ }
+ }
+ isSupported = parseSupported;
+ }
+ }
+ return has[name] = !!isSupported;
+ }
+ has["bug-string-char-index"] = null;
+ has["json"] = null;
+ has["json-stringify"] = null;
+ has["json-parse"] = null;
+
+ Iif (!has("json")) {
+ // Common `[[Class]]` name aliases.
+ var functionClass = "[object Function]";
+ var dateClass = "[object Date]";
+ var numberClass = "[object Number]";
+ var stringClass = "[object String]";
+ var arrayClass = "[object Array]";
+ var booleanClass = "[object Boolean]";
+
+ // Detect incomplete support for accessing string characters by index.
+ var charIndexBuggy = has("bug-string-char-index");
+
+ // Define additional utility methods if the `Date` methods are buggy.
+ if (!isExtended) {
+ var floor = Math.floor;
+ // A mapping between the months of the year and the number of days between
+ // January 1st and the first of the respective month.
+ var Months = [0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334];
+ // Internal: Calculates the number of days between the Unix epoch and the
+ // first day of the given month.
+ var getDay = function (year, month) {
+ return Months[month] + 365 * (year - 1970) + floor((year - 1969 + (month = +(month > 1))) / 4) - floor((year - 1901 + month) / 100) + floor((year - 1601 + month) / 400);
+ };
+ }
+
+ // Internal: Determines if a property is a direct property of the given
+ // object. Delegates to the native `Object#hasOwnProperty` method.
+ if (!(isProperty = {}.hasOwnProperty)) {
+ isProperty = function (property) {
+ var members = {}, constructor;
+ if ((members.__proto__ = null, members.__proto__ = {
+ // The *proto* property cannot be set multiple times in recent
+ // versions of Firefox and SeaMonkey.
+ "toString": 1
+ }, members).toString != getClass) {
+ // Safari <= 2.0.3 doesn't implement `Object#hasOwnProperty`, but
+ // supports the mutable *proto* property.
+ isProperty = function (property) {
+ // Capture and break the object's prototype chain (see section 8.6.2
+ // of the ES 5.1 spec). The parenthesized expression prevents an
+ // unsafe transformation by the Closure Compiler.
+ var original = this.__proto__, result = property in (this.__proto__ = null, this);
+ // Restore the original prototype chain.
+ this.__proto__ = original;
+ return result;
+ };
+ } else {
+ // Capture a reference to the top-level `Object` constructor.
+ constructor = members.constructor;
+ // Use the `constructor` property to simulate `Object#hasOwnProperty` in
+ // other environments.
+ isProperty = function (property) {
+ var parent = (this.constructor || constructor).prototype;
+ return property in this && !(property in parent && this[property] === parent[property]);
+ };
+ }
+ members = null;
+ return isProperty.call(this, property);
+ };
+ }
+
+ // Internal: A set of primitive types used by `isHostType`.
+ var PrimitiveTypes = {
+ 'boolean': 1,
+ 'number': 1,
+ 'string': 1,
+ 'undefined': 1
+ };
+
+ // Internal: Determines if the given object `property` value is a
+ // non-primitive.
+ var isHostType = function (object, property) {
+ var type = typeof object[property];
+ return type == 'object' ? !!object[property] : !PrimitiveTypes[type];
+ };
+
+ // Internal: Normalizes the `for...in` iteration algorithm across
+ // environments. Each enumerated key is yielded to a `callback` function.
+ forEach = function (object, callback) {
+ var size = 0, Properties, members, property;
+
+ // Tests for bugs in the current environment's `for...in` algorithm. The
+ // `valueOf` property inherits the non-enumerable flag from
+ // `Object.prototype` in older versions of IE, Netscape, and Mozilla.
+ (Properties = function () {
+ this.valueOf = 0;
+ }).prototype.valueOf = 0;
+
+ // Iterate over a new instance of the `Properties` class.
+ members = new Properties();
+ for (property in members) {
+ // Ignore all properties inherited from `Object.prototype`.
+ if (isProperty.call(members, property)) {
+ size++;
+ }
+ }
+ Properties = members = null;
+
+ // Normalize the iteration algorithm.
+ if (!size) {
+ // A list of non-enumerable properties inherited from `Object.prototype`.
+ members = ["valueOf", "toString", "toLocaleString", "propertyIsEnumerable", "isPrototypeOf", "hasOwnProperty", "constructor"];
+ // IE <= 8, Mozilla 1.0, and Netscape 6.2 ignore shadowed non-enumerable
+ // properties.
+ forEach = function (object, callback) {
+ var isFunction = getClass.call(object) == functionClass, property, length;
+ var hasProperty = !isFunction && typeof object.constructor != 'function' && isHostType(object, 'hasOwnProperty') ? object.hasOwnProperty : isProperty;
+ for (property in object) {
+ // Gecko <= 1.0 enumerates the `prototype` property of functions under
+ // certain conditions; IE does not.
+ if (!(isFunction && property == "prototype") && hasProperty.call(object, property)) {
+ callback(property);
+ }
+ }
+ // Manually invoke the callback for each non-enumerable property.
+ for (length = members.length; property = members[--length]; hasProperty.call(object, property) && callback(property));
+ };
+ } else if (size == 2) {
+ // Safari <= 2.0.4 enumerates shadowed properties twice.
+ forEach = function (object, callback) {
+ // Create a set of iterated properties.
+ var members = {}, isFunction = getClass.call(object) == functionClass, property;
+ for (property in object) {
+ // Store each property name to prevent double enumeration. The
+ // `prototype` property of functions is not enumerated due to cross-
+ // environment inconsistencies.
+ if (!(isFunction && property == "prototype") && !isProperty.call(members, property) && (members[property] = 1) && isProperty.call(object, property)) {
+ callback(property);
+ }
+ }
+ };
+ } else {
+ // No bugs detected; use the standard `for...in` algorithm.
+ forEach = function (object, callback) {
+ var isFunction = getClass.call(object) == functionClass, property, isConstructor;
+ for (property in object) {
+ if (!(isFunction && property == "prototype") && isProperty.call(object, property) && !(isConstructor = property === "constructor")) {
+ callback(property);
+ }
+ }
+ // Manually invoke the callback for the `constructor` property due to
+ // cross-environment inconsistencies.
+ if (isConstructor || isProperty.call(object, (property = "constructor"))) {
+ callback(property);
+ }
+ };
+ }
+ return forEach(object, callback);
+ };
+
+ // Public: Serializes a JavaScript `value` as a JSON string. The optional
+ // `filter` argument may specify either a function that alters how object and
+ // array members are serialized, or an array of strings and numbers that
+ // indicates which properties should be serialized. The optional `width`
+ // argument may be either a string or number that specifies the indentation
+ // level of the output.
+ if (!has("json-stringify")) {
+ // Internal: A map of control characters and their escaped equivalents.
+ var Escapes = {
+ 92: "\\\\",
+ 34: '\\"',
+ 8: "\\b",
+ 12: "\\f",
+ 10: "\\n",
+ 13: "\\r",
+ 9: "\\t"
+ };
+
+ // Internal: Converts `value` into a zero-padded string such that its
+ // length is at least equal to `width`. The `width` must be <= 6.
+ var leadingZeroes = "000000";
+ var toPaddedString = function (width, value) {
+ // The `|| 0` expression is necessary to work around a bug in
+ // Opera <= 7.54u2 where `0 == -0`, but `String(-0) !== "0"`.
+ return (leadingZeroes + (value || 0)).slice(-width);
+ };
+
+ // Internal: Double-quotes a string `value`, replacing all ASCII control
+ // characters (characters with code unit values between 0 and 31) with
+ // their escaped equivalents. This is an implementation of the
+ // `Quote(value)` operation defined in ES 5.1 section 15.12.3.
+ var unicodePrefix = "\\u00";
+ var quote = function (value) {
+ var result = '"', index = 0, length = value.length, isLarge = length > 10 && charIndexBuggy, symbols;
+ if (isLarge) {
+ symbols = value.split("");
+ }
+ for (; index < length; index++) {
+ var charCode = value.charCodeAt(index);
+ // If the character is a control character, append its Unicode or
+ // shorthand escape sequence; otherwise, append the character as-is.
+ switch (charCode) {
+ case 8: case 9: case 10: case 12: case 13: case 34: case 92:
+ result += Escapes[charCode];
+ break;
+ default:
+ if (charCode < 32) {
+ result += unicodePrefix + toPaddedString(2, charCode.toString(16));
+ break;
+ }
+ result += isLarge ? symbols[index] : charIndexBuggy ? value.charAt(index) : value[index];
+ }
+ }
+ return result + '"';
+ };
+
+ // Internal: Recursively serializes an object. Implements the
+ // `Str(key, holder)`, `JO(value)`, and `JA(value)` operations.
+ var serialize = function (property, object, callback, properties, whitespace, indentation, stack) {
+ var value, className, year, month, date, time, hours, minutes, seconds, milliseconds, results, element, index, length, prefix, hasMembers, result;
+ try {
+ // Necessary for host object support.
+ value = object[property];
+ } catch (exception) {}
+ if (typeof value == "object" && value) {
+ className = getClass.call(value);
+ if (className == dateClass && !isProperty.call(value, "toJSON")) {
+ if (value > -1 / 0 && value < 1 / 0) {
+ // Dates are serialized according to the `Date#toJSON` method
+ // specified in ES 5.1 section 15.9.5.44. See section 15.9.1.15
+ // for the ISO 8601 date time string format.
+ if (getDay) {
+ // Manually compute the year, month, date, hours, minutes,
+ // seconds, and milliseconds if the `getUTC*` methods are
+ // buggy. Adapted from @Yaffle's `date-shim` project.
+ date = floor(value / 864e5);
+ for (year = floor(date / 365.2425) + 1970 - 1; getDay(year + 1, 0) <= date; year++);
+ for (month = floor((date - getDay(year, 0)) / 30.42); getDay(year, month + 1) <= date; month++);
+ date = 1 + date - getDay(year, month);
+ // The `time` value specifies the time within the day (see ES
+ // 5.1 section 15.9.1.2). The formula `(A % B + B) % B` is used
+ // to compute `A modulo B`, as the `%` operator does not
+ // correspond to the `modulo` operation for negative numbers.
+ time = (value % 864e5 + 864e5) % 864e5;
+ // The hours, minutes, seconds, and milliseconds are obtained by
+ // decomposing the time within the day. See section 15.9.1.10.
+ hours = floor(time / 36e5) % 24;
+ minutes = floor(time / 6e4) % 60;
+ seconds = floor(time / 1e3) % 60;
+ milliseconds = time % 1e3;
+ } else {
+ year = value.getUTCFullYear();
+ month = value.getUTCMonth();
+ date = value.getUTCDate();
+ hours = value.getUTCHours();
+ minutes = value.getUTCMinutes();
+ seconds = value.getUTCSeconds();
+ milliseconds = value.getUTCMilliseconds();
+ }
+ // Serialize extended years correctly.
+ value = (year <= 0 || year >= 1e4 ? (year < 0 ? "-" : "+") + toPaddedString(6, year < 0 ? -year : year) : toPaddedString(4, year)) +
+ "-" + toPaddedString(2, month + 1) + "-" + toPaddedString(2, date) +
+ // Months, dates, hours, minutes, and seconds should have two
+ // digits; milliseconds should have three.
+ "T" + toPaddedString(2, hours) + ":" + toPaddedString(2, minutes) + ":" + toPaddedString(2, seconds) +
+ // Milliseconds are optional in ES 5.0, but required in 5.1.
+ "." + toPaddedString(3, milliseconds) + "Z";
+ } else {
+ value = null;
+ }
+ } else if (typeof value.toJSON == "function" && ((className != numberClass && className != stringClass && className != arrayClass) || isProperty.call(value, "toJSON"))) {
+ // Prototype <= 1.6.1 adds non-standard `toJSON` methods to the
+ // `Number`, `String`, `Date`, and `Array` prototypes. JSON 3
+ // ignores all `toJSON` methods on these objects unless they are
+ // defined directly on an instance.
+ value = value.toJSON(property);
+ }
+ }
+ if (callback) {
+ // If a replacement function was provided, call it to obtain the value
+ // for serialization.
+ value = callback.call(object, property, value);
+ }
+ if (value === null) {
+ return "null";
+ }
+ className = getClass.call(value);
+ if (className == booleanClass) {
+ // Booleans are represented literally.
+ return "" + value;
+ } else if (className == numberClass) {
+ // JSON numbers must be finite. `Infinity` and `NaN` are serialized as
+ // `"null"`.
+ return value > -1 / 0 && value < 1 / 0 ? "" + value : "null";
+ } else if (className == stringClass) {
+ // Strings are double-quoted and escaped.
+ return quote("" + value);
+ }
+ // Recursively serialize objects and arrays.
+ if (typeof value == "object") {
+ // Check for cyclic structures. This is a linear search; performance
+ // is inversely proportional to the number of unique nested objects.
+ for (length = stack.length; length--;) {
+ if (stack[length] === value) {
+ // Cyclic structures cannot be serialized by `JSON.stringify`.
+ throw TypeError();
+ }
+ }
+ // Add the object to the stack of traversed objects.
+ stack.push(value);
+ results = [];
+ // Save the current indentation level and indent one additional level.
+ prefix = indentation;
+ indentation += whitespace;
+ if (className == arrayClass) {
+ // Recursively serialize array elements.
+ for (index = 0, length = value.length; index < length; hasMembers || (hasMembers = true), index++) {
+ element = serialize(index, value, callback, properties, whitespace, indentation, stack);
+ results.push(element === undef ? "null" : element);
+ }
+ result = hasMembers ? (whitespace ? "[\n" + indentation + results.join(",\n" + indentation) + "\n" + prefix + "]" : ("[" + results.join(",") + "]")) : "[]";
+ } else {
+ // Recursively serialize object members. Members are selected from
+ // either a user-specified list of property names, or the object
+ // itself.
+ forEach(properties || value, function (property) {
+ var element = serialize(property, value, callback, properties, whitespace, indentation, stack);
+ if (element !== undef) {
+ // According to ES 5.1 section 15.12.3: "If `gap` {whitespace}
+ // is not the empty string, let `member` {quote(property) + ":"}
+ // be the concatenation of `member` and the `space` character."
+ // The "`space` character" refers to the literal space
+ // character, not the `space` {width} argument provided to
+ // `JSON.stringify`.
+ results.push(quote(property) + ":" + (whitespace ? " " : "") + element);
+ }
+ hasMembers || (hasMembers = true);
+ });
+ result = hasMembers ? (whitespace ? "{\n" + indentation + results.join(",\n" + indentation) + "\n" + prefix + "}" : ("{" + results.join(",") + "}")) : "{}";
+ }
+ // Remove the object from the traversed object stack.
+ stack.pop();
+ return result;
+ }
+ };
+
+ // Public: `JSON.stringify`. See ES 5.1 section 15.12.3.
+ JSON3.stringify = function (source, filter, width) {
+ var whitespace, callback, properties, className;
+ if (typeof filter == "function" || typeof filter == "object" && filter) {
+ if ((className = getClass.call(filter)) == functionClass) {
+ callback = filter;
+ } else if (className == arrayClass) {
+ // Convert the property names array into a makeshift set.
+ properties = {};
+ for (var index = 0, length = filter.length, value; index < length; value = filter[index++], ((getClass.call(value) == stringClass || getClass.call(value) == numberClass) && (properties[value] = 1)));
+ }
+ }
+ if (width) {
+ if ((className = getClass.call(width)) == numberClass) {
+ // Convert the `width` to an integer and create a string containing
+ // `width` number of space characters.
+ if ((width -= width % 1) > 0) {
+ for (whitespace = "", width > 10 && (width = 10); whitespace.length < width; whitespace += " ");
+ }
+ } else if (className == stringClass) {
+ whitespace = width.length <= 10 ? width : width.slice(0, 10);
+ }
+ }
+ // Opera <= 7.54u2 discards the values associated with empty string keys
+ // (`""`) only if they are used directly within an object member list
+ // (e.g., `!("" in { "": 1})`).
+ return serialize("", (value = {}, value[""] = source, value), callback, properties, whitespace, "", []);
+ };
+ }
+
+ // Public: Parses a JSON source string.
+ if (!has("json-parse")) {
+ var fromCharCode = String.fromCharCode;
+
+ // Internal: A map of escaped control characters and their unescaped
+ // equivalents.
+ var Unescapes = {
+ 92: "\\",
+ 34: '"',
+ 47: "/",
+ 98: "\b",
+ 116: "\t",
+ 110: "\n",
+ 102: "\f",
+ 114: "\r"
+ };
+
+ // Internal: Stores the parser state.
+ var Index, Source;
+
+ // Internal: Resets the parser state and throws a `SyntaxError`.
+ var abort = function() {
+ Index = Source = null;
+ throw SyntaxError();
+ };
+
+ // Internal: Returns the next token, or `"$"` if the parser has reached
+ // the end of the source string. A token may be a string, number, `null`
+ // literal, or Boolean literal.
+ var lex = function () {
+ var source = Source, length = source.length, value, begin, position, isSigned, charCode;
+ while (Index < length) {
+ charCode = source.charCodeAt(Index);
+ switch (charCode) {
+ case 9: case 10: case 13: case 32:
+ // Skip whitespace tokens, including tabs, carriage returns, line
+ // feeds, and space characters.
+ Index++;
+ break;
+ case 123: case 125: case 91: case 93: case 58: case 44:
+ // Parse a punctuator token (`{`, `}`, `[`, `]`, `:`, or `,`) at
+ // the current position.
+ value = charIndexBuggy ? source.charAt(Index) : source[Index];
+ Index++;
+ return value;
+ case 34:
+ // `"` delimits a JSON string; advance to the next character and
+ // begin parsing the string. String tokens are prefixed with the
+ // sentinel `@` character to distinguish them from punctuators and
+ // end-of-string tokens.
+ for (value = "@", Index++; Index < length;) {
+ charCode = source.charCodeAt(Index);
+ if (charCode < 32) {
+ // Unescaped ASCII control characters (those with a code unit
+ // less than the space character) are not permitted.
+ abort();
+ } else if (charCode == 92) {
+ // A reverse solidus (`\`) marks the beginning of an escaped
+ // control character (including `"`, `\`, and `/`) or Unicode
+ // escape sequence.
+ charCode = source.charCodeAt(++Index);
+ switch (charCode) {
+ case 92: case 34: case 47: case 98: case 116: case 110: case 102: case 114:
+ // Revive escaped control characters.
+ value += Unescapes[charCode];
+ Index++;
+ break;
+ case 117:
+ // `\u` marks the beginning of a Unicode escape sequence.
+ // Advance to the first character and validate the
+ // four-digit code point.
+ begin = ++Index;
+ for (position = Index + 4; Index < position; Index++) {
+ charCode = source.charCodeAt(Index);
+ // A valid sequence comprises four hexdigits (case-
+ // insensitive) that form a single hexadecimal value.
+ if (!(charCode >= 48 && charCode <= 57 || charCode >= 97 && charCode <= 102 || charCode >= 65 && charCode <= 70)) {
+ // Invalid Unicode escape sequence.
+ abort();
+ }
+ }
+ // Revive the escaped character.
+ value += fromCharCode("0x" + source.slice(begin, Index));
+ break;
+ default:
+ // Invalid escape sequence.
+ abort();
+ }
+ } else {
+ if (charCode == 34) {
+ // An unescaped double-quote character marks the end of the
+ // string.
+ break;
+ }
+ charCode = source.charCodeAt(Index);
+ begin = Index;
+ // Optimize for the common case where a string is valid.
+ while (charCode >= 32 && charCode != 92 && charCode != 34) {
+ charCode = source.charCodeAt(++Index);
+ }
+ // Append the string as-is.
+ value += source.slice(begin, Index);
+ }
+ }
+ if (source.charCodeAt(Index) == 34) {
+ // Advance to the next character and return the revived string.
+ Index++;
+ return value;
+ }
+ // Unterminated string.
+ abort();
+ default:
+ // Parse numbers and literals.
+ begin = Index;
+ // Advance past the negative sign, if one is specified.
+ if (charCode == 45) {
+ isSigned = true;
+ charCode = source.charCodeAt(++Index);
+ }
+ // Parse an integer or floating-point value.
+ if (charCode >= 48 && charCode <= 57) {
+ // Leading zeroes are interpreted as octal literals.
+ if (charCode == 48 && ((charCode = source.charCodeAt(Index + 1)), charCode >= 48 && charCode <= 57)) {
+ // Illegal octal literal.
+ abort();
+ }
+ isSigned = false;
+ // Parse the integer component.
+ for (; Index < length && ((charCode = source.charCodeAt(Index)), charCode >= 48 && charCode <= 57); Index++);
+ // Floats cannot contain a leading decimal point; however, this
+ // case is already accounted for by the parser.
+ if (source.charCodeAt(Index) == 46) {
+ position = ++Index;
+ // Parse the decimal component.
+ for (; position < length && ((charCode = source.charCodeAt(position)), charCode >= 48 && charCode <= 57); position++);
+ if (position == Index) {
+ // Illegal trailing decimal.
+ abort();
+ }
+ Index = position;
+ }
+ // Parse exponents. The `e` denoting the exponent is
+ // case-insensitive.
+ charCode = source.charCodeAt(Index);
+ if (charCode == 101 || charCode == 69) {
+ charCode = source.charCodeAt(++Index);
+ // Skip past the sign following the exponent, if one is
+ // specified.
+ if (charCode == 43 || charCode == 45) {
+ Index++;
+ }
+ // Parse the exponential component.
+ for (position = Index; position < length && ((charCode = source.charCodeAt(position)), charCode >= 48 && charCode <= 57); position++);
+ if (position == Index) {
+ // Illegal empty exponent.
+ abort();
+ }
+ Index = position;
+ }
+ // Coerce the parsed value to a JavaScript number.
+ return +source.slice(begin, Index);
+ }
+ // A negative sign may only precede numbers.
+ if (isSigned) {
+ abort();
+ }
+ // `true`, `false`, and `null` literals.
+ if (source.slice(Index, Index + 4) == "true") {
+ Index += 4;
+ return true;
+ } else if (source.slice(Index, Index + 5) == "false") {
+ Index += 5;
+ return false;
+ } else if (source.slice(Index, Index + 4) == "null") {
+ Index += 4;
+ return null;
+ }
+ // Unrecognized token.
+ abort();
+ }
+ }
+ // Return the sentinel `$` character if the parser has reached the end
+ // of the source string.
+ return "$";
+ };
+
+ // Internal: Parses a JSON `value` token.
+ var get = function (value) {
+ var results, hasMembers;
+ if (value == "$") {
+ // Unexpected end of input.
+ abort();
+ }
+ if (typeof value == "string") {
+ if ((charIndexBuggy ? value.charAt(0) : value[0]) == "@") {
+ // Remove the sentinel `@` character.
+ return value.slice(1);
+ }
+ // Parse object and array literals.
+ if (value == "[") {
+ // Parses a JSON array, returning a new JavaScript array.
+ results = [];
+ for (;; hasMembers || (hasMembers = true)) {
+ value = lex();
+ // A closing square bracket marks the end of the array literal.
+ if (value == "]") {
+ break;
+ }
+ // If the array literal contains elements, the current token
+ // should be a comma separating the previous element from the
+ // next.
+ if (hasMembers) {
+ if (value == ",") {
+ value = lex();
+ if (value == "]") {
+ // Unexpected trailing `,` in array literal.
+ abort();
+ }
+ } else {
+ // A `,` must separate each array element.
+ abort();
+ }
+ }
+ // Elisions and leading commas are not permitted.
+ if (value == ",") {
+ abort();
+ }
+ results.push(get(value));
+ }
+ return results;
+ } else if (value == "{") {
+ // Parses a JSON object, returning a new JavaScript object.
+ results = {};
+ for (;; hasMembers || (hasMembers = true)) {
+ value = lex();
+ // A closing curly brace marks the end of the object literal.
+ if (value == "}") {
+ break;
+ }
+ // If the object literal contains members, the current token
+ // should be a comma separator.
+ if (hasMembers) {
+ if (value == ",") {
+ value = lex();
+ if (value == "}") {
+ // Unexpected trailing `,` in object literal.
+ abort();
+ }
+ } else {
+ // A `,` must separate each object member.
+ abort();
+ }
+ }
+ // Leading commas are not permitted, object property names must be
+ // double-quoted strings, and a `:` must separate each property
+ // name and value.
+ if (value == "," || typeof value != "string" || (charIndexBuggy ? value.charAt(0) : value[0]) != "@" || lex() != ":") {
+ abort();
+ }
+ results[value.slice(1)] = get(lex());
+ }
+ return results;
+ }
+ // Unexpected token encountered.
+ abort();
+ }
+ return value;
+ };
+
+ // Internal: Updates a traversed object member.
+ var update = function(source, property, callback) {
+ var element = walk(source, property, callback);
+ if (element === undef) {
+ delete source[property];
+ } else {
+ source[property] = element;
+ }
+ };
+
+ // Internal: Recursively traverses a parsed JSON object, invoking the
+ // `callback` function for each value. This is an implementation of the
+ // `Walk(holder, name)` operation defined in ES 5.1 section 15.12.2.
+ var walk = function (source, property, callback) {
+ var value = source[property], length;
+ if (typeof value == "object" && value) {
+ // `forEach` can't be used to traverse an array in Opera <= 8.54
+ // because its `Object#hasOwnProperty` implementation returns `false`
+ // for array indices (e.g., `![1, 2, 3].hasOwnProperty("0")`).
+ if (getClass.call(value) == arrayClass) {
+ for (length = value.length; length--;) {
+ update(value, length, callback);
+ }
+ } else {
+ forEach(value, function (property) {
+ update(value, property, callback);
+ });
+ }
+ }
+ return callback.call(source, property, value);
+ };
+
+ // Public: `JSON.parse`. See ES 5.1 section 15.12.2.
+ JSON3.parse = function (source, callback) {
+ var result, value;
+ Index = 0;
+ Source = "" + source;
+ result = get(lex());
+ // If a JSON string contains multiple tokens, it is invalid.
+ if (lex() != "$") {
+ abort();
+ }
+ // Reset the parser state.
+ Index = Source = null;
+ return callback && getClass.call(callback) == functionClass ? walk((value = {}, value[""] = result, value), "", callback) : result;
+ };
+ }
+ }
+
+ // Export for asynchronous module loaders.
+ Iif (isLoader) {
+ define(function () {
+ return JSON3;
+ });
+ }
+}(this));
+ |