使用JavaScript实现检测网页是否为空闲状态_Javascript

1. 背景

最近开发项目时，常碰到“用户在一定时间内无任何操作时，跳转到某个页面”的需求。

网上冲浪后，也没有找到一个比较好的js封装去解决这个问题，从而决定自己实现。

2. 如何判断页面是否空闲(用户长时间无操作)

首先，我们要知道什么是空闲？用户一定时间内，没有对网页进行任何操作，则当前网页为空闲状态。

用户操作网页，无非就是通过鼠标、键盘两个输入设备(暂不考虑手柄等设备)。因而我们可以监听相应的输入事件，来判断网页是否空闲(用户是否操作网页)。

监听鼠标移动事件mousemove；
监听键盘按下事件mousedown；
在用户进入网页后，设置延时跳转，如果触发以上事件，则移除延时器，并重新开始。

3. 网页空闲检测实现

3.1 简易实现

以下代码，简易实现了一个判断网页空闲的方法。

const onidledetection = (callback, timeout = 15, immediate = false) => {
  let pagetimer;
  
  const oncleartimer = () => {
    pagetimer && cleartimeout(pagetimer);
    pagetimer = undefined;
  };
  const onstarttimer = () => {
    oncleartimer();
    pagetimer = settimeout(() => {
      callback();
    }, timeout * 1000);
  };

  const startdetection = () => {
    onstarttimer();
    document.addeventlistener('mousedown', onstarttimer);
    document.addeventlistener('mousemove', onstarttimer);
  };
  const stopdetection = () => {
    oncleartimer();
    document.removeeventlistener('mousedown', onstarttimer);
    document.removeeventlistener('mousemove', onstarttimer);
  };
  const restartdetection = () => {
      oncleartimer();
      onstarttimer();
  };

  if (immediate) {
    startdetection();
  }

  return {
    startdetection,
    stopdetection,
    restartdetection
  };
};

也许你注意到了，我并没有针对onstarttimer事件进行防抖，那这是不是会对性能有影响呢？

是的，肯定有那么点影响，那我为啥不添加防抖呢？

这是因为添加防抖后，形成了settimeout嵌套，嵌套settimeout会有精度问题（参考）。

或许你还会说，非活动标签页（网页被隐藏）的settimeout的执行和精度会有问题（参考非活动标签的超时）。

确实存在以上问题，接下来我们就来一一解决吧！

3.2 处理频繁触发问题

我们可以通过添加一个变量记录开始执行时间，当下一次执行与当前的时间间隔小于某个值时直接退出函数，从而解决这个问题(节流思想应用)。

const onidledetection = (callback, timeout = 15, immediate = false) => {
  let pagetimer;
  // 记录开始时间
  let begintime = 0;
  const onstarttimer = () => {
    // 触发间隔小于100ms时，直接返回
    const currenttime = date.now();
    if (pagetimer && currenttime - begintime < 100) {
      return;
    }

    oncleartimer();
    // 更新开始时间
    begintime = currenttime;
    pagetimer = settimeout(() => {
      callback();
    }, timeout * 1000);
  };
  const oncleartimer = () => {
    pagetimer && cleartimeout(pagetimer);
    pagetimer = undefined;
  };
  
  const startdetection = () => {
    onstarttimer();
    document.addeventlistener('mousedown', onstarttimer);
    document.addeventlistener('mousemove', onstarttimer);
  };
  const stopdetection = () => {
    oncleartimer();
    document.removeeventlistener('mousedown', onstarttimer);
    document.removeeventlistener('mousemove', onstarttimer);
  };
  const restartdetection = () => {
      oncleartimer();
      onstarttimer();
  };
  
  if (immediate) {
    startdetection();
  }

  return {
    startdetection,
    stopdetection,
    restartdetection
  };
};

3.3 处理页面被隐藏的情况(完整实现)

我们可以监听visibilitychange事件，在页面隐藏时移除延时器，然后页面显示时继续计时，从而解决这个问题。

/**
 * 网页空闲检测
 * @param {() => void} callback 空闲时执行，即一定时长无操作时触发
 * @param {number} [timeout=15] 时长，默认15s，单位：秒
 * @param {boolean} [immediate=false] 是否立即开始，默认 false
 * @returns
 */
const onidledetection = (callback, timeout = 15, immediate = false) => {
  let pagetimer;
  let begintime = 0;
  const oncleartimer = () => {
    pagetimer && cleartimeout(pagetimer);
    pagetimer = undefined;
  };
  const onstarttimer = () => {
    const currenttime = date.now();
    if (pagetimer && currenttime - begintime < 100) {
      return;
    }

    oncleartimer();
    begintime = currenttime;
    pagetimer = settimeout(() => {
      callback();
    }, timeout * 1000);
  };

  const onpagevisibility = () => {
     // 页面显示状态改变时，移除延时器
     oncleartimer();

     if (document.visibilitystate === 'visible') {
       const currenttime = date.now();
       // 页面显示时，计算时间，如果超出限制时间则直接执行回调函数
       if (currenttime - begintime >= timeout * 1000) {
         callback();
         return;
       }
       // 继续计时
       pagetimer = settimeout(() => {
         callback();
       }, timeout * 1000 - (currenttime - begintime));
     }
  };

  const startdetection = () => {
    onstarttimer();
    document.addeventlistener('mousedown', onstarttimer);
    document.addeventlistener('mousemove', onstarttimer);
    document.addeventlistener('visibilitychange', onpagevisibility);
  };

  const stopdetection = () => {
    oncleartimer();
    document.removeeventlistener('mousedown', onstarttimer);
    document.removeeventlistener('mousemove', onstarttimer);
    document.removeeventlistener('visibilitychange', onpagevisibility);
  };
  
  const restartdetection = () => {
      oncleartimer();
      onstarttimer();
  };

  if (immediate) {
    startdetection();
  }

  return {
    startdetection,
    stopdetection,
    restartdetection
  };
};

通过以上代码，我们就完整地实现了一个网页空闲状态检测的方法。