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

@ngnjs/libnet-node

v1.0.0-alpha.1

Published

A plugin module for NGN.

Downloads

3

Readme

This module polyfills network request features normally only found in non-Node runtimes:

  1. Cache
  2. ReferrerPolicy
  3. Subresource Integrity
  4. Local Interfaces*

*Local interfaces is an array of the computer interfaces, including hostname and IP addresses (IPv4 and IPv6).

Usage

npm i ngn @ngnjs/libnet-node -S

import NGN from 'ngn'
import { Caches, ReferrerPolicy, SRI, INTERFACES } from '@ngnjs/libnet-node'

This library is technically standalone, but it as designed specifically to support the NGN network library in the Node.js runtime. It can be used elsewhere, but it requires a recent version of Node.js (12.x.x+).

Network Polyfills

The Fetch API in browsers have more management features than the raw network libraries found in Node-like runtimes. Until these environments have feature-parity, the polyfills in this directory will be used to fill gaps for Node-like environments.

HTTP Cache

Browsers contain an HTTP Cache, capable of private (specific browsing session) and shared caches (across browsing sessions, i.e. multiple tabs).

Node-like environments lack these features, but NGN supports both using the NGN Cache polyfill. Nothing special is required to use these features. However; there are some options for tweaking/customizing the cache (see below).

Private Caching

Private caching is accomplished using an in-memory cache per process. This is an ephemeral cache, so it will be purged when the process exits. This cache cannot be shared with other running processes.

If you need the private cache to persist between process restarts, the shared caching can be used (see note at end).

Shared Caching

Shared caching is accomplished using disk. Responses are written to a directory. Multiple processes can use the same directory, resulting in a shared caching system. This can reduce considerable bandwidth usage in systems which make many similar requests to the same destinations, from multiple processes.

To enable shared caching, a cache directory must exist, be writable by the process, and be defined as an envionrment variable: HTTP_CACHE_DIR. Example: HTTP_CACHE_DIR=/path/to/cache node index.js

NOTE: Shared caching is just disk-based caching. To create a private and persistent cache, specify a unique directory path per private process.

WARNING This cache will work and is safe to use in production envionrment, but it just runs as a Node process. If/when Node supports an HTTP Cache, this feature will be replaced. The current caching system is designed for 90% of use cases. If you have specific/advanced caching needs, it may be better to write your own caching system or use several of the database (Redis/SQLite) backed caching systems available for Node.js.

Referrer Policy

The W3C Referrer Policy specification provides a standard set of policies for controlling the type of meta information sent to destinations (using the Referer HTTP request header). Node-like network libraries do not support this policy by default.

The popularity/growth of projects like Electron, NW.js, and greater need for customization of metadata in HTTP requests continues to increase. NGN adds support for this standard.

Subresource Integrity

Subresource Integrity (SRI) is a security feature that enables HTTP clients to verify resources retrieved (for example, from a CDN, API, or remote data provider) are delivered without unexpected manipulation. It's like checksum for HTTP.

NGN adds simple support for hash matching, throwing an error when content cannot be verified (i.e. handled the same as a browser would handle it).