Exciting news!Announcing our $4.6M Series Seed. Learn more
Socket
LoveBlogFAQ
Install
Log in

@kurtz1993/idle-service

Package Overview
Dependencies
0
Maintainers
1
Versions
6
Issues
File Explorer

Advanced tools

@kurtz1993/idle-service

A RxJS based service that responds to idle users.

    2.0.3latest

Version published
Maintainers
1
Yearly downloads
7,333
increased by255.45%

Weekly downloads

Readme

Source

idle-service

npm (scoped)

This version requires RxJS v6, if you want to use RxJS v5 check the RxJS 5 branch.

Description

Some applications may need to detect if a user is idle and perform certain actions when this happens like warning them about this inactivity or logging them out of the application.

Installation

You can install the module via npm install @kurtz1993/idle-service or yarn add @kurtz1993/idle-service.

Usage

import idleService, { IdleEvents } from '@kurtz1993/idle-service'; idleService.configure({ timeToIdle: 10, timeToTimeout: 5, autoResume: true, listenFor: 'click mousemove', }); idleService.on(IdleEvents.UserIsBack, () => { console.log('User is back!'); }); idleService.on(IdleEvents.UserHasTimedOut, () => { console.log('User has timed out!'); }); idleService.on(IdleEvents.TimeoutWarning, countdown => { console.log(`User has ${countdown} seconds to come back!`); }); idleService.on(IdleEvents.UserIsIdle, () => { console.log('User has become idle!'); }); idleService.on(IdleEvents.UserIsActive, () => { console.log('User is active'); }); idleService.start();

Configuration

You can configure the service to change the default timers and other options by calling the configure method.

import idleService from 'idle-service'; idleService.configure({ timeToIdle: 10, timeToTimeout: 5, autoResume: true, listenFor: 'click mousemove', });

Events

These are the events available within the IdleService:

enum IdleEvents { UserIsActive UserIsIdle UserIsBack TimeoutWarning UserHasTimedOut }

API Reference

class IdleOptions { /** * Inactive time in seconds that the user needs to be considered idle. */ timeToIdle: number; /** * Inactive time in seconds needed for the user to be considered timed out *AFTER* the user has been considered idle. */ timeToTimeout: number; /** * Specifies if the service should auto resume itself after the user is considered idle. */ autoResume: boolean; /** * DOM events to listen for the user to be considered active. */ listenFor: string; } class IdleService { userState: UserState; /** * Configures the service with the given parameters. * @param options New options to configure the service. You can just pass the needed keys. */ configure(options: Partial<IdleOptions>): void; /** * Starts watching user activity. */ start(): void; /** * Stops the service from running. * Service can be restarted by calling the start() method. * @param timedOut Specifies if the service was stopped because of the user being timedout. */ stop(timedOut?: boolean): void; /** * Resets the service. */ reset: () => void; /** * Starts the timeout countdown. * If the user performs a valid action, the countdown stops. */ startTimeoutCountdown(): void; /** * Listens to a particular idle service event. * @param eventType Event to listen to. * @param action What the event listener should do when the event is triggered. */ on(eventType: IdleEvents, action: (value: any) => void): Subscription; class UserState { /** * Specifies if the user is idle. */ isIdle: boolean; /** * Specifies if the user has timed out. */ hasTimedout: boolean; /** * Number of seconds the user has been inactive. */ userInactivityTime: number; }

Keywords

Socket

Product

Subscribe to our newsletter

Get open source security insights delivered straight into your inbox. Be the first to learn about new features and product updates.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc