7 个基本的 JS 函数【译】

本文由 伯乐在线 - 刘健超-J.c 翻译，进林 校稿。未经许可，禁止转载！
英文出处：davidwalsh.name。欢迎加入翻译组。

我记得早期的 JavaScript ，要完成任何事情几乎都绕不开一些简单的函数，因为浏览器提供商实现功能有所差异，而且不只是边缘功能，基础功能也一样，如 addEventListener 和 attachEvent。虽然时代变了，但仍有一些函数是每个开发者都应该掌握的，以便于完成某些功能和提高性能。

debounce

对于高耗能事件，debounce 函数是一种不错解决方案。如果你不对 scroll、resize、和 key* 事件使用 debounce  函数，那么你几乎等同于犯了错误。下面的 debounce 函数能让你的代码保持高效：

// 返回一个函数，如果它被不间断地调用，它将不会得到执行。该函数在停止调用 N 毫秒后，再次调用它才会得到执行。如果有传递 ‘immediate’ 参数，会马上将函数安排到执行队列中，而不会延迟。
function debounce(func, wait, immediate) {
    var timeout;
    return function() {
        var context = this, args = arguments;
        var later = function() {
            timeout = null;
            if (!immediate) func.apply(context, args);
        };
        var callNow = immediate && !timeout;
        clearTimeout(timeout);
        timeout = setTimeout(later, wait);
        if (callNow) func.apply(context, args);
    };
};

// 用法
var myEfficientFn = debounce(function() {

// 所有繁重的操作
}, 250);
window.addEventListener('resize', myEfficientFn);

debounce 函数不允许回调函数在指定时间内执行多于一次。当为一个会频繁触发的事件分配一个回调函数时，该函数显得尤为重要。

poll

尽管上面我提及了 debounce 函数，但如果事件不存在时，你就不能插入一个事件以判断所需的状态，那么就需要每隔一段时间去检查状态是否达到你的要求。

function poll(fn, callback, errback, timeout, interval) {
    var endTime = Number(new Date()) + (timeout || 2000);
    interval = interval || 100;

    (function p() {

// 如果条件满足，则执行！
            if(fn()) {
                callback();
            }

// 如果条件不满足，但并未超时，再来一次
            else if (Number(new Date()) < endTime) {
                setTimeout(p, interval);
            }

// 不匹配且时间消耗过长，则拒绝！
            else {
                errback(new Error('timed out for ' + fn + ': ' + arguments));
            }
    })();
}

// 用法：确保元素可见
poll(
    function() {
        return document.getElementById('lightbox').offsetWidth > 0;
    },
    function() {

// 执行，成功的回调函数
    },
    function() {

// 错误，失败的回调函数
    }
);

Polling 在 web 中已被应用很长时间了，并在将来仍会被使用。

once

有时候，你想让一个给定的功能只发生一次，类似于 onload 事件。下面的代码提供了你所说的功能：

function once(fn, context) {
    var result;

    return function() {
        if(fn) {
            result = fn.apply(context || this, arguments);
            fn = null;
        }

        return result;
    };
}

// 用法
var canOnlyFireOnce = once(function() {
    console.log('Fired!');
});

canOnlyFireOnce();
// "Fired!"
canOnlyFireOnce();
// nada  

// 没有执行指定函数

once 函数确保给定函数只能被调用一次，从而防止重复初始化！

getAbsoluteUrl

从一个字符串变量得到一个绝对 URL，并不是你想象中这么简单。对于某些 URL 构造器，如果你不提供必要的参数就会出问题（而有时候你真的不知道提供什么参数）。下面有一个优雅的技巧，只需要你传递一个字符串就能得到相应的绝对 URL。

var getAbsoluteUrl = (function() {
    var a;

    return function(url) {
        if(!a) a = document.createElement('a');
        a.href = url;

        return a.href;
    };
})();

// 用法
getAbsoluteUrl('/something');
// http://davidwalsh.name/something

a 元素的 href 处理和 url 处理看似无意义，而 return 语句返回了一个可靠的绝对 URL。

isNative

如果你想知道一个指定函数是否是原生的，或者能不能通过声明来覆盖它。下面这段便于使用的代码能给你答案：

;(function() {

// 用于处理传入参数 value 的内部 `[[Class]]`
  var toString = Object.prototype.toString;

// 用于解析函数的反编译代码
  var fnToString = Function.prototype.toString;

// 用于检测宿主构造器 （Safari > 4 ;真的输出特定的数组）
  var reHostCtor = /^[object .+?Constructor]$/;

// 用一个标准的原生方法作为模板，编译一个正则表达式。

// 我们选择 'Object#toString' 因为它一般不会被污染。
  var reNative = RegExp('^' +

// 将 'Object#toString' 强制转为字符串
    String(toString)

// 转义所有指定的正则表达式字符
    .replace(/[.*+?^${}()|[]/]/g, '$&')

// 用 '.*?' 替换提及的 'toString' ，以保持模板的通用性。

// 将 'for ...' 之类的字符替换掉，以兼容 Rhino 等环境，因为这些环境添加了额外的信息，如方法参数数量。
    .replace(/toString|(function).*?(?=()| for .+?(?=])/g, '$1.*?') + '$'
  );

  function isNative(value) {
    var type = typeof value;
    return type == 'function'

// 用 'Function#toString' （fnToString）绕过了值（value）本身的 'toString' 方法，以免被伪造所欺骗。
      ? reNative.test(fnToString.call(value))

// 回退到宿主对象的检查，因为某些环境（浏览器）将类型数组（typed arrays）之类的东西当作 DOM 方法，此时可能不遵循标准的原生正则表达式。
      : (value && type == 'object' && reHostCtor.test(toString.call(value))) || false;
  }

// 导出函数
  module.exports = isNative;
}());

// 用法
isNative(alert);
// true
isNative(myCustomFunction);
// false

这个函数虽不完美，但它能完成任务！

insertRule

我们都知道能通过选择器（通过 document.querySelectorAll ）获取一个 NodeList ，并可为每个元素设置样式，但有什么更高效的方法为选择器设置样式呢（例如你可以在样式表里完成）：

var sheet = (function() {

// 创建 <style> 标签
    var style = document.createElement('style');

// 如果你需要指定媒介类型，则可以在此添加一个 media (和/或 media query) 

// style.setAttribute('media', 'screen')

// style.setAttribute('media', 'only screen and (max-width : 1024px)')

// WebKit hack :(
    style.appendChild(document.createTextNode(''));

// 将 <style> 元素添加到页面
    document.head.appendChild(style);

    return style.sheet;
})();

// 用法
sheet.insertRule("header { float: left; opacity: 0.8; }", 1);

这对于一个动态且重度依赖 AJAX 的网站来说是特别有用的。如果你为一个选择器设置样式，那么你就不需要为每个匹配到的元素都设置样式（现在或将来）。

matchesSelector

我们经常会在进行下一步操作前进行输入校验，以确保是一个可靠值，或确保表单数据是有效的，等等。但我们平时是怎么确保一个元素是否有资格进行进一步操作呢？如果一个元素有给定匹配的选择器，那么你可以使用 matchesSelector 函数来校验：

function matchesSelector(el, selector) {
    var p = Element.prototype;
    var f = p.matches || p.webkitMatchesSelector || p.mozMatchesSelector || p.msMatchesSelector || function(s) {
        return [].indexOf.call(document.querySelectorAll(s), this) !== -1;
    };
    return f.call(el, selector);
}

// 用法
matchesSelector(document.getElementById('myDiv'), 'div.someSelector[some-attribute=true]')

就这样啦，上述 7 个 JavaScript 函数是每个开发者都应该时刻记着的。有哪个函数我错过了呢？请把它分享出来！