Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

broccoli-node-info

Package Overview
Dependencies
Maintainers
4
Versions
5
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

broccoli-node-info

Inspect Broccoli nodes; thin wrapper around node.__broccoliGetInfo__()

  • 2.2.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
393K
decreased by-12.26%
Maintainers
4
Weekly downloads
 
Created
Source

broccoli-node-info

This is a low-level package used to communicate with Broccoli nodes (that is, plugin instances). It provides a thin wrapper around node.__broccoliGetInfo__(), normalizing different versions of the node API to the newest version.

This package is mainly used by the Broccoli Builder class, but it can also be used for inspecting nodes for testing, wrapping, diagnostics, or similar purposes. If you are tempted to call node.__broccoliGetInfo__() or access private variables on broccoli-plugin instances, such as node._name or node._inputNodes, then use this package instead!

For background on the Broccoli node API, see docs/node-api.md.

Usage

var broccoliNodeInfo = require('broccoli-node-info');

node = new SomeBroccoliPlugin();

var nodeInfo = broccoliNodeInfo.getNodeInfo(node);
// Now we can use nodeInfo.name, nodeInfo.annotation, etc.

getNodeInfo(node)

This function calls node.__broccoliGetInfo__(broccoliNodeInfo.features).

For node objects conforming to the most recent node API, it simply returns the resulting nodeInfo object.

For node object conforming to an older version of the node API, it provides compatibility code to normalize the nodeInfo object.

As a result, regardless of the API version used by the node object, we obtain a nodeInfo object conforming to the current specification in docs/node-api.md

This function throws a broccoliNodeInfo.InvalidNodeError when called with

  • a plain string node (while still supported by the Broccoli Builder, they are deprecated in favor of broccoli-source),
  • a node using the old .read/.rebuild API (see docs/broccoli-1-0-plugin-api.md), or
  • some other object that isn't a node.

InvalidNodeError

Error subclass, potentially thrown by getNodeInfo().

features

A hash of all supported feature flags. This hash acts like a version number for the node API. In the current version, its value is

{
  persistentOutputFlag: true,
  sourceDirectories: true
}

Keywords

FAQs

Package last updated on 25 May 2021

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc