pax_global_header00006660000000000000000000000064137321760330014517gustar00rootroot0000000000000052 comment=3e32b4d5eed957aa0bd432c7f13f4a12ca7631ec is-callable-1.2.2/000077500000000000000000000000001373217603300136715ustar00rootroot00000000000000is-callable-1.2.2/.editorconfig000066400000000000000000000004641373217603300163520ustar00rootroot00000000000000root = true [*] indent_style = tab indent_size = 4 end_of_line = lf charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true max_line_length = 150 [CHANGELOG.md] indent_style = space indent_size = 2 max_line_length = off [*.json] max_line_length = off [Makefile] max_line_length = off is-callable-1.2.2/.eslintrc000066400000000000000000000004461373217603300155210ustar00rootroot00000000000000{ "root": true, "extends": "@ljharb", "rules": { "id-length": 0, "max-statements": [2, 12], "max-statements-per-line": [2, { "max": 2 }], "operator-linebreak": [2, "before"], }, "overrides": [ { "files": "test/**", "rules": { "no-throw-literal": 0, }, }, ], } is-callable-1.2.2/.github/000077500000000000000000000000001373217603300152315ustar00rootroot00000000000000is-callable-1.2.2/.github/FUNDING.yml000066400000000000000000000011061373217603300170440ustar00rootroot00000000000000# These are supported funding model platforms github: [ljharb] patreon: # Replace with a single Patreon username open_collective: # Replace with a single Open Collective username ko_fi: # Replace with a single Ko-fi username tidelift: npm/is-callable community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry liberapay: # Replace with a single Liberapay username issuehunt: # Replace with a single IssueHunt username otechie: # Replace with a single Otechie username custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2'] is-callable-1.2.2/.github/main.workflow000066400000000000000000000004021373217603300177450ustar00rootroot00000000000000workflow "Autorebase branch on merge commits" { on = "push" resolves = ["rebase"] } workflow "Autorebase PR on merge commits" { on = "pull_request" resolves = ["rebase"] } action "rebase" { uses = "ljharb/rebase@latest" secrets = ["GITHUB_TOKEN"] } is-callable-1.2.2/.github/workflows/000077500000000000000000000000001373217603300172665ustar00rootroot00000000000000is-callable-1.2.2/.github/workflows/rebase.yml000066400000000000000000000003721373217603300212540ustar00rootroot00000000000000name: Automatic Rebase on: [pull_request] jobs: _: name: "Automatic Rebase" runs-on: ubuntu-latest steps: - uses: actions/checkout@v1 - uses: ljharb/rebase@master env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} is-callable-1.2.2/.gitignore000066400000000000000000000012741373217603300156650ustar00rootroot00000000000000# Logs logs *.log # Runtime data pids *.pid *.seed # Directory for instrumented libs generated by jscoverage/JSCover lib-cov # Coverage directory used by tools like istanbul coverage coverage-harmony coverage-std # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files) .grunt # Compiled binary addons (http://nodejs.org/api/addons.html) build/Release # Dependency directory # Commenting this out is preferred by some people, see # https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git- node_modules # Users Environment Variables .lock-wscript # Only apps should have lockfiles yarn.lock package-lock.json npm-shrinkwrap.json is-callable-1.2.2/.istanbul.yml000066400000000000000000000017411373217603300163160ustar00rootroot00000000000000verbose: false instrumentation: root: . extensions: - .js - .jsx default-excludes: true excludes: [] variable: __coverage__ compact: true preserve-comments: false complete-copy: false save-baseline: false baseline-file: ./coverage/coverage-baseline.raw.json include-all-sources: false include-pid: false es-modules: false auto-wrap: false reporting: print: summary reports: - html dir: ./coverage summarizer: pkg report-config: {} watermarks: statements: [50, 80] functions: [50, 80] branches: [50, 80] lines: [50, 80] hooks: hook-run-in-context: false post-require-hook: null handle-sigint: false check: global: statements: 100 lines: 100 branches: 100 functions: 100 excludes: [] each: statements: 100 lines: 100 branches: 100 functions: 100 excludes: [] is-callable-1.2.2/.npmrc000066400000000000000000000000231373217603300150040ustar00rootroot00000000000000package-lock=false is-callable-1.2.2/.travis.yml000066400000000000000000000003741373217603300160060ustar00rootroot00000000000000version: ~> 1.0 language: node_js os: - linux import: - ljharb/travis-ci:node/all.yml - ljharb/travis-ci:node/pretest.yml - ljharb/travis-ci:node/posttest.yml - ljharb/travis-ci:node/coverage.yml matrix: allow_failures: - env: COVERAGE=true is-callable-1.2.2/CHANGELOG.md000066400000000000000000000062221373217603300155040ustar00rootroot000000000000001.2.2 / 2020-09-21 ================= * [Fix] include actual fix from 579179e * [Dev Deps] update `eslint` 1.2.1 / 2020-09-09 ================= * [Fix] phantomjs‘ Reflect.apply does not throw properly on a bad array-like * [Dev Deps] update `eslint`, `@ljharb/eslint-config` * [meta] fix eclint error 1.2.0 / 2020-06-02 ================= * [New] use `Reflect.apply`‑based callability detection * [readme] add install instructions (#55) * [meta] only run `aud` on prod deps * [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `tape`, `make-arrow-function`, `make-generator-function`; add `aud`, `safe-publish-latest`, `make-async-function` * [Tests] add tests for function proxies (#53, #25) 1.1.5 / 2019-12-18 ================= * [meta] remove unused Makefile and associated utilities * [meta] add `funding` field; add FUNDING.yml * [Dev Deps] update `eslint`, `@ljharb/eslint-config`, `semver`, `tape`, `covert`, `rimraf` * [Tests] use shared travis configs * [Tests] use `eccheck` over `editorconfig-tools` * [Tests] use `npx aud` instead of `nsp` or `npm audit` with hoops * [Tests] remove `jscs` * [actions] add automatic rebasing / merge commit blocking 1.1.4 / 2018-07-02 ================= * [Fix] improve `class` and arrow function detection (#30, #31) * [Tests] on all latest node minors; improve matrix * [Dev Deps] update all dev deps 1.1.3 / 2016-02-27 ================= * [Fix] ensure “class “ doesn’t screw up “class” detection * [Tests] up to `node` `v5.7`, `v4.3` * [Dev Deps] update to `eslint` v2, `@ljharb/eslint-config`, `jscs` 1.1.2 / 2016-01-15 ================= * [Fix] Make sure comments don’t screw up “class” detection (#4) * [Tests] up to `node` `v5.3` * [Tests] Add `parallelshell`, run both `--es-staging` and stock tests at once * [Dev Deps] update `tape`, `jscs`, `nsp`, `eslint`, `@ljharb/eslint-config` * [Refactor] convert `isNonES6ClassFn` into `isES6ClassFn` 1.1.1 / 2015-11-30 ================= * [Fix] do not throw when a non-function has a function in its [[Prototype]] (#2) * [Dev Deps] update `tape`, `eslint`, `@ljharb/eslint-config`, `jscs`, `nsp`, `semver` * [Tests] up to `node` `v5.1` * [Tests] no longer allow node 0.8 to fail. * [Tests] fix npm upgrades in older nodes 1.1.0 / 2015-10-02 ================= * [Fix] Some browsers report TypedArray constructors as `typeof object` * [New] return false for "class" constructors, when possible. * [Tests] up to `io.js` `v3.3`, `node` `v4.1` * [Dev Deps] update `eslint`, `editorconfig-tools`, `nsp`, `tape`, `semver`, `jscs`, `covert`, `make-arrow-function` * [Docs] Switch from vb.teelaun.ch to versionbadg.es for the npm version badge SVG 1.0.4 / 2015-01-30 ================= * If @@toStringTag is not present, use the old-school Object#toString test. 1.0.3 / 2015-01-29 ================= * Add tests to ensure arrow functions are callable. * Refactor to aid optimization of non-try/catch code. 1.0.2 / 2015-01-29 ================= * Fix broken package.json 1.0.1 / 2015-01-29 ================= * Add early exit for typeof not "function" 1.0.0 / 2015-01-29 ================= * Initial release. is-callable-1.2.2/LICENSE000066400000000000000000000020721373217603300146770ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2015 Jordan Harband 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. is-callable-1.2.2/README.md000066400000000000000000000037661373217603300151640ustar00rootroot00000000000000# is-callable [![Version Badge][2]][1] [![Build Status][3]][4] [![dependency status][5]][6] [![dev dependency status][7]][8] [![License][license-image]][license-url] [![Downloads][downloads-image]][downloads-url] [![npm badge][11]][1] [![browser support][9]][10] Is this JS value callable? Works with Functions and GeneratorFunctions, despite ES6 @@toStringTag. ## Example ```js var isCallable = require('is-callable'); var assert = require('assert'); assert.notOk(isCallable(undefined)); assert.notOk(isCallable(null)); assert.notOk(isCallable(false)); assert.notOk(isCallable(true)); assert.notOk(isCallable([])); assert.notOk(isCallable({})); assert.notOk(isCallable(/a/g)); assert.notOk(isCallable(new RegExp('a', 'g'))); assert.notOk(isCallable(new Date())); assert.notOk(isCallable(42)); assert.notOk(isCallable(NaN)); assert.notOk(isCallable(Infinity)); assert.notOk(isCallable(new Number(42))); assert.notOk(isCallable('foo')); assert.notOk(isCallable(Object('foo'))); assert.ok(isCallable(function () {})); assert.ok(isCallable(function* () {})); assert.ok(isCallable(x => x * x)); ``` ## Install Install with ``` npm install is-callable ``` ## Tests Simply clone the repo, `npm install`, and run `npm test` [1]: https://npmjs.org/package/is-callable [2]: http://versionbadg.es/ljharb/is-callable.svg [3]: https://travis-ci.org/ljharb/is-callable.svg [4]: https://travis-ci.org/ljharb/is-callable [5]: https://david-dm.org/ljharb/is-callable.svg [6]: https://david-dm.org/ljharb/is-callable [7]: https://david-dm.org/ljharb/is-callable/dev-status.svg [8]: https://david-dm.org/ljharb/is-callable#info=devDependencies [9]: https://ci.testling.com/ljharb/is-callable.png [10]: https://ci.testling.com/ljharb/is-callable [11]: https://nodei.co/npm/is-callable.png?downloads=true&stars=true [license-image]: http://img.shields.io/npm/l/is-callable.svg [license-url]: LICENSE [downloads-image]: http://img.shields.io/npm/dm/is-callable.svg [downloads-url]: http://npm-stat.com/charts.html?package=is-callable is-callable-1.2.2/index.js000066400000000000000000000040551373217603300153420ustar00rootroot00000000000000'use strict'; var fnToStr = Function.prototype.toString; var reflectApply = typeof Reflect === 'object' && Reflect !== null && Reflect.apply; var badArrayLike; var isCallableMarker; if (typeof reflectApply === 'function' && typeof Object.defineProperty === 'function') { try { badArrayLike = Object.defineProperty({}, 'length', { get: function () { throw isCallableMarker; } }); isCallableMarker = {}; // eslint-disable-next-line no-throw-literal reflectApply(function () { throw 42; }, null, badArrayLike); } catch (_) { if (_ !== isCallableMarker) { reflectApply = null; } } } else { reflectApply = null; } var constructorRegex = /^\s*class\b/; var isES6ClassFn = function isES6ClassFunction(value) { try { var fnStr = fnToStr.call(value); return constructorRegex.test(fnStr); } catch (e) { return false; // not a function } }; var tryFunctionObject = function tryFunctionToStr(value) { try { if (isES6ClassFn(value)) { return false; } fnToStr.call(value); return true; } catch (e) { return false; } }; var toStr = Object.prototype.toString; var fnClass = '[object Function]'; var genClass = '[object GeneratorFunction]'; var hasToStringTag = typeof Symbol === 'function' && typeof Symbol.toStringTag === 'symbol'; module.exports = reflectApply ? function isCallable(value) { if (!value) { return false; } if (typeof value !== 'function' && typeof value !== 'object') { return false; } if (typeof value === 'function' && !value.prototype) { return true; } try { reflectApply(value, null, badArrayLike); } catch (e) { if (e !== isCallableMarker) { return false; } } return !isES6ClassFn(value); } : function isCallable(value) { if (!value) { return false; } if (typeof value !== 'function' && typeof value !== 'object') { return false; } if (typeof value === 'function' && !value.prototype) { return true; } if (hasToStringTag) { return tryFunctionObject(value); } if (isES6ClassFn(value)) { return false; } var strClass = toStr.call(value); return strClass === fnClass || strClass === genClass; }; is-callable-1.2.2/package.json000066400000000000000000000052671373217603300161710ustar00rootroot00000000000000{ "name": "is-callable", "version": "1.2.2", "author": { "name": "Jordan Harband", "email": "ljharb@gmail.com", "url": "http://ljharb.codes" }, "funding": { "url": "https://github.com/sponsors/ljharb" }, "contributors": [ { "name": "Jordan Harband", "email": "ljharb@gmail.com", "url": "http://ljharb.codes" } ], "description": "Is this JS value callable? Works with Functions and GeneratorFunctions, despite ES6 @@toStringTag.", "license": "MIT", "main": "index.js", "scripts": { "prepublish": "safe-publish-latest", "pretest": "npm run --silent lint", "test": "npm run --silent tests-only", "posttest": "npx aud --production", "tests-only": "npm run --silent test:stock && npm run --silent test:staging", "test:stock": "node test", "test:staging": "node --es-staging test", "coverage": "npm run --silent istanbul", "covert": "covert test", "covert:quiet": "covert test --quiet", "istanbul": "npm run --silent istanbul:clean && npm run --silent istanbul:std && npm run --silent istanbul:harmony && npm run --silent istanbul:merge && istanbul check", "istanbul:clean": "rimraf coverage coverage-std coverage-harmony", "istanbul:merge": "istanbul-merge --out coverage/coverage.raw.json coverage-harmony/coverage.raw.json coverage-std/coverage.raw.json && istanbul report html", "istanbul:harmony": "node --harmony ./node_modules/istanbul/lib/cli.js cover test --dir coverage-harmony", "istanbul:std": "istanbul cover test --report html --dir coverage-std", "prelint": "eclint check *", "lint": "eslint ." }, "repository": { "type": "git", "url": "git://github.com/ljharb/is-callable.git" }, "keywords": [ "Function", "function", "callable", "generator", "generator function", "arrow", "arrow function", "ES6", "toStringTag", "@@toStringTag" ], "dependencies": {}, "devDependencies": { "@ljharb/eslint-config": "^17.2.0", "aud": "^1.1.2", "covert": "^1.1.1", "eclint": "^2.8.1", "eslint": "^7.9.0", "foreach": "^2.0.5", "istanbul": "1.1.0-alpha.1", "istanbul-merge": "^1.1.1", "make-arrow-function": "^1.2.0", "make-async-function": "^1.0.0", "make-generator-function": "^2.0.0", "rimraf": "^2.7.1", "safe-publish-latest": "^1.1.4", "tape": "^5.0.1" }, "testling": { "files": "test/index.js", "browsers": [ "iexplore/6.0..latest", "firefox/3.0..6.0", "firefox/15.0..latest", "firefox/nightly", "chrome/4.0..10.0", "chrome/20.0..latest", "chrome/canary", "opera/10.0..latest", "opera/next", "safari/4.0..latest", "ipad/6.0..latest", "iphone/6.0..latest", "android-browser/4.2" ] }, "engines": { "node": ">= 0.4" }, "greenkeeper": { "ignore": [ "rimraf" ] } } is-callable-1.2.2/test/000077500000000000000000000000001373217603300146505ustar00rootroot00000000000000is-callable-1.2.2/test/index.js000066400000000000000000000144031373217603300163170ustar00rootroot00000000000000'use strict'; /* globals Proxy */ /* eslint no-magic-numbers: 1 */ var test = require('tape'); var isCallable = require('../'); var hasSymbols = typeof Symbol === 'function' && typeof Symbol('foo') === 'symbol'; var generators = require('make-generator-function')(); var arrows = require('make-arrow-function').list(); var asyncs = require('make-async-function').list(); var weirdlyCommentedArrowFn; try { /* eslint-disable no-new-func */ weirdlyCommentedArrowFn = Function('return cl/*/**/=>/**/ass - 1;')(); /* eslint-enable no-new-func */ } catch (e) { /**/ } var forEach = require('foreach'); var noop = function () {}; var classFake = function classFake() { }; // eslint-disable-line func-name-matching var returnClass = function () { return ' class '; }; var return3 = function () { return 3; }; /* for coverage */ noop(); classFake(); returnClass(); return3(); /* end for coverage */ var proxy; if (typeof Proxy === 'function') { try { proxy = new Proxy(function () {}, {}); // for coverage proxy(); String(proxy); } catch (_) { // If `Reflect` is supported, then `Function.prototype.toString` isn't used for callability detection. if (typeof Reflect !== 'object') { // Older engines throw a `TypeError` when `Function.prototype.toString` is called on a Proxy object. proxy = null; } } } var invokeFunction = function invokeFunctionString(str) { var result; try { /* eslint-disable no-new-func */ var fn = Function(str); /* eslint-enable no-new-func */ result = fn(); } catch (e) {} return result; }; var classConstructor = invokeFunction('"use strict"; return class Foo {}'); var commentedClass = invokeFunction('"use strict"; return class/*kkk*/\n//blah\n Bar\n//blah\n {}'); var commentedClassOneLine = invokeFunction('"use strict"; return class/**/A{}'); var classAnonymous = invokeFunction('"use strict"; return class{}'); var classAnonymousCommentedOneLine = invokeFunction('"use strict"; return class/*/*/{}'); test('not callables', function (t) { t.test('non-number/string primitives', function (st) { st.notOk(isCallable(), 'undefined is not callable'); st.notOk(isCallable(null), 'null is not callable'); st.notOk(isCallable(false), 'false is not callable'); st.notOk(isCallable(true), 'true is not callable'); st.end(); }); t.notOk(isCallable([]), 'array is not callable'); t.notOk(isCallable({}), 'object is not callable'); t.notOk(isCallable(/a/g), 'regex literal is not callable'); t.notOk(isCallable(new RegExp('a', 'g')), 'regex object is not callable'); t.notOk(isCallable(new Date()), 'new Date() is not callable'); t.test('numbers', function (st) { st.notOk(isCallable(42), 'number is not callable'); st.notOk(isCallable(Object(42)), 'number object is not callable'); st.notOk(isCallable(NaN), 'NaN is not callable'); st.notOk(isCallable(Infinity), 'Infinity is not callable'); st.end(); }); t.test('strings', function (st) { st.notOk(isCallable('foo'), 'string primitive is not callable'); st.notOk(isCallable(Object('foo')), 'string object is not callable'); st.end(); }); t.test('non-function with function in its [[Prototype]] chain', function (st) { var Foo = function Bar() {}; Foo.prototype = noop; st.equal(true, isCallable(Foo), 'sanity check: Foo is callable'); st.equal(false, isCallable(new Foo()), 'instance of Foo is not callable'); st.end(); }); t.end(); }); test('@@toStringTag', { skip: !hasSymbols || !Symbol.toStringTag }, function (t) { var fakeFunction = { toString: function () { return String(return3); }, valueOf: return3 }; fakeFunction[Symbol.toStringTag] = 'Function'; t.equal(String(fakeFunction), String(return3)); t.equal(Number(fakeFunction), return3()); t.notOk(isCallable(fakeFunction), 'fake Function with @@toStringTag "Function" is not callable'); t.end(); }); var typedArrayNames = [ 'Int8Array', 'Uint8Array', 'Uint8ClampedArray', 'Int16Array', 'Uint16Array', 'Int32Array', 'Uint32Array', 'Float32Array', 'Float64Array' ]; test('Functions', function (t) { t.ok(isCallable(noop), 'function is callable'); t.ok(isCallable(classFake), 'function with name containing "class" is callable'); t.ok(isCallable(returnClass), 'function with string " class " is callable'); t.ok(isCallable(isCallable), 'isCallable is callable'); t.end(); }); test('Typed Arrays', function (st) { forEach(typedArrayNames, function (typedArray) { /* istanbul ignore if : covered in node 0.6 */ if (typeof global[typedArray] === 'undefined') { st.comment('# SKIP typed array "' + typedArray + '" not supported'); } else { st.ok(isCallable(global[typedArray]), typedArray + ' is callable'); } }); st.end(); }); test('Generators', { skip: generators.length === 0 }, function (t) { forEach(generators, function (genFn) { t.ok(isCallable(genFn), 'generator function ' + genFn + ' is callable'); }); t.end(); }); test('Arrow functions', { skip: arrows.length === 0 }, function (t) { forEach(arrows, function (arrowFn) { t.ok(isCallable(arrowFn), 'arrow function ' + arrowFn + ' is callable'); }); t.ok(isCallable(weirdlyCommentedArrowFn), 'weirdly commented arrow functions are callable'); t.end(); }); test('"Class" constructors', { skip: !classConstructor || !commentedClass || !commentedClassOneLine || !classAnonymous }, function (t) { t.notOk(isCallable(classConstructor), 'class constructors are not callable'); t.notOk(isCallable(commentedClass), 'class constructors with comments in the signature are not callable'); t.notOk(isCallable(commentedClassOneLine), 'one-line class constructors with comments in the signature are not callable'); t.notOk(isCallable(classAnonymous), 'anonymous class constructors are not callable'); t.notOk(isCallable(classAnonymousCommentedOneLine), 'anonymous one-line class constructors with comments in the signature are not callable'); t.end(); }); test('`async function`s', { skip: asyncs.length === 0 }, function (t) { forEach(asyncs, function (asyncFn) { t.ok(isCallable(asyncFn), '`async function` ' + asyncFn + ' is callable'); }); t.end(); }); test('proxies of functions', { skip: !proxy }, function (t) { t.ok(isCallable(proxy), 'proxies of functions are callable'); t.end(); }); test('throwing functions', function (t) { t.plan(1); var thrower = function (a) { return a.b; }; t.ok(isCallable(thrower), 'a function that throws is callable'); });