Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
periscopic
Advanced tools
Changelog
4.0.2
Readme
Utility for analyzing scopes belonging to an ESTree-compliant AST.
import { analyze } from 'periscopic';
const ast = acorn.parse(`
const a = b;
console.log(a);
`);
const { map, globals, scope } = analyze(ast);
map
is a WeakMap<Node, Scope>
, where the keys are the nodes of your AST that create a scopeglobals
is a Map<string, Node>
of all the identifiers that are referenced without being declared anywhere in the program (in this case, b
and console
)scope
is the top-level Scope
belonging to the programEach Scope
instance has the following properties:
scope.block
— true if the scope is created by a block statement (i.e. let
, const
and class
are contained to it), false otherwisescope.parent
— the parent scope objectscope.declarations
— a Map<string, Node>
of all the variables declared in this scope, the node value referes to the declaration statementscope.initialised_declarations
— a Set<string>
of all the variables declared and initialised in this scopescope.references
— a Set<string>
of all the names referenced in this scope (or child scopes)It also has two methods:
scope.has(name)
— returns true
if name
is declared in this scope or an ancestor scopescope.find_owner(name)
— returns the scope object in which name
is declared (or null
if it is not declared)extract_identifiers
and extract_names
This package also exposes utilities for extracting the identifiers contained in a declaration or a function parameter:
import { extract_identifiers, extract_names } from 'periscopic';
const ast = acorn.parse(`
const { a, b: [c, d] = e } = opts;
`);
const lhs = ast.body[0].declarations[0].id;
extract_identifiers(lhs);
/*
[
{ type: 'Identifier', name: 'a', start: 9, end: 10 },
{ type: 'Identifier', name: 'c', start: 16, end: 17 },
{ type: 'Identifier', name: 'd', start: 19, end: 20 }
]
*/
extract_names(lhs);
/*
['a', 'c', 'd']
*/
FAQs
periscopic
The npm package periscopic receives a total of 978,145 weekly downloads. As such, periscopic popularity was classified as popular.
We found that periscopic demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
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.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.