Compare commits

...

No commits in common. "v1.0.1" and "master" have entirely different histories.

6 changed files with 201 additions and 42 deletions

41
LICENSE Normal file
View File

@ -0,0 +1,41 @@
Copyright 2018 AJ ONeal
This is open source software; you can redistribute it and/or modify it under the
terms of either:
a) the "MIT License"
b) the "Apache-2.0 License"
MIT License
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.
Apache-2.0 License Summary
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

View File

@ -9,11 +9,19 @@ This works in both the Browser and SSJS.
require('remedial');
Notes
----
Usage / API
`typeOf` is taken from `jQuery.type`, which is more accurate than Crockford's original and even simpler
than the ["Flanagan / Miller device"](http://groups.google.com/group/nodejs/msg/0670a986a2906aeb).
There is [a more specific typeof()](http://rolandog.com/archives/2007/01/18/typeof-a-more-specific-typeof/) implementation also worthy of consideration.
Globals
====
typeOf(o)
----
Since JavaScript is a loosely-typed language, it is sometimes necessary to examine a value to determine its type. (This is sometimes necessary in strongly typed languages as well.) JavaScript provides a typeof operator to facilitate this, but typeof has problems.
@ -36,8 +44,8 @@ isEmpty(v)
isEmpty(v) returns true if v is an object containing no enumerable members.
**String Methods**
----
String Methods
====
JavaScript provides some useful methods for strings, but leaves out some important ones. Fortunately, JavaScript allows us to add new methods to the basic types.

View File

@ -1,20 +1,23 @@
/*jslint onevar: true, undef: true, nomen: true, eqeqeq: true, plusplus: true, bitwise: true, regexp: true, newcap: true, immed: true */
"use strict";
(function () {
function typeOf(value) {
var s = typeof value;
if (s === 'object') {
if (value) {
if (typeof value.length === 'number' &&
!(value.propertyIsEnumerable('length')) &&
typeof value.splice === 'function') {
s = 'array';
}
} else {
s = 'null';
}
}
return s;
"use strict";
var global = Function('return this')()
, classes = "Boolean Number String Function Array Date RegExp Object".split(" ")
, i
, name
, class2type = {}
;
for (i in classes) {
if (classes.hasOwnProperty(i)) {
name = classes[i];
class2type["[object " + name + "]"] = name.toLowerCase();
}
}
function typeOf(obj) {
return (null === obj || undefined === obj) ? String(obj) : class2type[Object.prototype.toString.call(obj)] || "object";
}
function isEmpty(o) {
@ -92,15 +95,11 @@
};
}
// Boiler Plate
if ('undefined' === typeof module) { module = {}; }
// CommonJS / npm / Ender.JS
module.exports = {
typeOf: typeOf,
isEmpty: isEmpty
};
if ('undefined' === typeof global) { global = window; }
global.typeOf = global.typeOf || typeOf;
global.isEmpty = global.isEmpty || isEmpty;
if ('undefined' === typeof provide) { provide = function () {}; }
provide('remedial');
}());

View File

@ -1,21 +1,14 @@
{
"author": "AJ ONeal <coolaj86@gmail.com> (https://coolaj86.com)",
"contributors": [ "Douglas Crockford <douglas@crockford.com>" ],
"dependencies": {},
"description": "Deprecated. Utilities for ES3, most of which have been adopted or superseded in ES5.1. Adapted from Douglas Crockford's Remedial JavaScript",
"engines": { "node": "*" },
"keywords": [
"util",
"isEmpty",
"typeOf",
"entityify",
"quote",
"supplant",
"trim"
],
"lib": "lib",
"main": "./lib/remedial",
"name": "remedial",
"homepage": "https://git.coolaj86.com/coolaj86/remedial.js",
"version": "1.0.1"
"name" : "remedial",
"description" : "Deprecated. Utilities for ES3, most of which have been adopted or superseded in ES5.1. Adapted from Douglas Crockford's Remedial JavaScript",
"url" : "http://javascript.crockford.com/remedial.html",
"keywords" : ["util", "isEmpty", "typeOf", "entityify", "quote", "supplant", "trim"],
"author" : "AJ ONeal <coolaj86@gmail.com> (https://coolaj86.com)",
"contributors" : [ "Douglas Crockford <douglas@crockford.com>" ],
"dependencies" : {},
"engines" : { "node": "*" },
"homepage" : "https://git.coolaj86.com/coolaj86/remedial.js",
"license" : "(MIT OR Apache-2.0)",
"main" : "./index",
"version" : "1.0.8"
}

87
tests/array-wtf.js Normal file
View File

@ -0,0 +1,87 @@
// Firefox was tested using persevere's global-es5 for es5 emulation
(function () {
require('../lib/remedial');
a = [];
a[2] = 27;
console.log(a);
// Expected: [undefined, undefined, 27];
// Node/V8: [ 27 ];
// FF3: [undefined, undefined, 27];
console.log(a.length);
// 3
console.log(typeOf(a));
// array
b = Object.create([]);
b[2] = 27;
console.log(b);
// Expected: [undefined, undefined, 27];
// Node/V8: [ 27 ]
console.log(b.length);
// Expected: 3
// Node/V8/FF: 0
console.log(typeOf(b));
// Expected: Object (with Flanagan / Miller device or jQuery's type)
// Node/V8/FF: array (with Crockford's original)
c = Object.create([]);
c.push();
c.push();
c.push(27);
console.log(c);
// Expected: [undefined, undefined, 27]
// Node: [ 27, length: 1 ]
// FF: []
console.log(c.length);
// Expected: 3
// Node/V8/FF: 1
console.log(typeOf(c));
// Expected: object
// Node/V8/FF: object
d = Object.create(Array);
// FF: Error: typeof prototype[function] != 'object'
d[2] = 27;
console.log(d);
// Expected: [undefined, undefined, 27];
// Node/V8: { '2': 27 }
console.log(d.length);
// Expected: 3
// Node/V8/FF: 1
console.log(typeOf(d));
// Expected: object
// Node/V8: object
}());
/*
Exact Node Output:
[ 27 ]
3
array
[ 27 ]
0
array
[ 27, length: 1 ]
1
object
Exact FF (firebug) Output (expanded):
[undefined, undefined, 27]
> 2 27
3
array
[]
> 2 27
0
array
[27]
> 0 27
length 1
1
object
*/

31
tests/types.js Normal file
View File

@ -0,0 +1,31 @@
(function () {
require('../lib/remedial');
var n = null,
u;
if (
'object' === typeOf(Object.create([])) &&
'object' === typeOf(Object.create(function () {})) &&
'array' === typeOf([]) &&
'string' === typeOf('') &&
'regexp' === typeOf(/ /) &&
'number' === typeOf(0) &&
'function' === typeOf(function () {}) &&
'function' === typeOf((function () {
var a = function () {};
a.foo = 'bar';
return a;
}())) &&
'boolean' === typeOf(true) &&
'boolean' === typeOf(false) &&
'date' === typeOf(new Date()) &&
'undefined' === typeOf(u) &&
'undefined' === typeOf(undefined) &&
'null' === typeOf(n) &&
'object' === typeOf({})
) {
console.log('passed type detections')
} else {
console.log('failed type detections')
}
}());