npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

iop-toaster

v1.1.0

Published

Toaster is a small library that allows you to create HTML Toasts - special messages that pop up at the top of the page, informing the user about events happening on the site.

Downloads

7

Readme

IOP-Toaster.js

Toaster is a small library that allows you to create HTML Toasts - special messages that pop up at the top of the page, informing the user about events happening on the site.

Why us?

  • Fast and easy to use and install - the Toast library makes it easy to create Toast notifications without having to write complex code. This makes it an ideal solution for web developers who want to add functionality quickly and effortlessly. It is also easy to install using NPM or by downloading the GitHub repository;
  • Versatility - the library offers several options and settings, which allows you to adapt toasts to your design and site style. This way, you can create unique and attractive notifications for users;
  • Availability - the library is provided free of charge, making it accessible to any developer. This allows you to save time and money without resorting to expensive solutions;
  • Browser support - the library is well tested and compatible with most modern browsers, which guarantees its stable operation on various devices;
  • Written in pure JS - Toaster is written entirely in JavaScript, without the use of any additional libraries or frameworks. This means that it is easy to use, understand and maintain. It can also be easily integrated into any web application or site as it does not require any additional dependencies;
  • Improving user experience - Toasts allow you to quickly and conveniently convey important information to the user, which improves his experience of interacting with a site or application. This could be information about successful registration, error, warning, etc.

Installations

1. NPM package manager

Through the terminal, run the following command in the root folder of the project:

npm i iop-toaster

In .js files, use import with the desired module path:

import {Cookie} from './node_modules/iop-toaster.js/src/iop-toaster.js';

Don't forget that your JavaScript files must be included as a modules:

<script src="index.js" type="module"></script>

2. Build from source

Go to /src folder of GitHub page and download script and style files. Include style to your HTML page using

<link rel="stylesheet" href="../path/to/your/styles/folder/iop-cookiemaster.css">

Then, include script to your HTML page using

<script src="../path/to/your/scripts/folder/iop-cookiemaster.js"></script>

Usage TODO

Create a session Cookie:

Cookie.set('cookieName', 'cookieValue');  // string Cookie
Cookie.set('user', {name: 'Alex', age: 18});  // JSON Cookie

Create a Cookie with options:

// Expiring string Cookie
Cookie.set('cookieName', 'cookieValue', {expires: new Date('2020-10-10 03:00:00')});
// Expiring JSON Cookie
Cookie.set('cookieName', {key: 'value'}, {expires: new Date('2020-10-10 03:00:00')});

Don't forget that JSON format supports only double quotes.

With Cookie.set() function, you can specify any cookie options you want. You can find options table there.

Get a cookie:

Cookie.get('cookieName')  // string cookies
Cookie.get('cookieName', true)  // JSON cookie, returns json object

Delete a cookie:

Cookie.delete('name');  // JSON or string cookie: no matter!

Setting Cookie options

For setting a Cookie option, call setCookie(name, value, dict) function filling dict parameter as dictionary.

Keys & values list:

  • path (string) - URL prefix of the path, Cookies will be available for pages under this path;
  • domain (string) - the domain determines where the Cookie is available;
  • expires (Date or string) - the exact expiration date of the cookie when the browser will delete it automatically;
  • max-age (number) - The expires alternative specifies the cookie's expiration date in seconds from the current moment;
  • secure (none) - if set, disables the use of Cookies on alternative connection protocols;
  • samesite (string) - security setting used to protect against the so-called XSRF attack;
  • httpOnly (bool) - prevents any access to cookies from JavaScript.

License

This library is distributed under the ISC license. License text:

Copyright (c) 2024, IOPjolnir <[email protected]>.

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.