Gathering detailed insights and metrics for potent-tools
Gathering detailed insights and metrics for potent-tools
Tools for working with the DOM, CSS selectors and XPath 1.0 expressions.
Installations
npm install potent-toolsDeveloper Guide
BETA
Typescript
No
Module System
CommonJS
Node Version
7.10.0
NPM Version
4.2.0
Releases
Unable to fetch releases
Languages
1
JavaScript
JavaScript (100%)
Developer
gburtini
Download Statistics
Total Downloads
0
Last Day
0
Last Week
0
Last Month
0
Last Year
0
GitHub Statistics
BSD-3-Clause License
4 Stars
52 Commits
1 Forks
1 Watchers
1 Branches
1 Contributors
Updated on May 27, 2023
Maintainers
1
Package Meta Information
Latest Version
2.2.6
Package Id
potent-tools@2.2.6
Size
261.60 kB
NPM Version
4.2.0
Node Version
7.10.0
Total Downloads
Cumulative downloads
Total Downloads
NaN
Last Day
0%
NaN
Compared to previous day
Last Week
0%
NaN
Compared to previous week
Last Month
0%
NaN
Compared to previous month
Last Year
0%
NaN
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Potent Tools for XPath and CSS
Tools for working with the DOM, CSS selectors and XPath 1.0 expressions. All functionality in this repository is derived from Firebug, and has been modified for readability and to support pseudo-DOM, unit testing and ES6 standards.
This package solves four loosely related problems:
- Evaluating XPath expressions on arbitrary documents (including pseudo-DOM)
- Generating XPath expressions for paths in DOM structures
- Converting CSS selectors to XPath expressions (for evaluation or otherwise)
- Parsing CSS selectors for meaning (e.g.
"body.thing"->{ element: body, class: thing }).
Installation
yarn add potent-tools
Usage
1const {
2 generators,
3 evaluators,
4 cssToXPath
5} = require('potent-tools');
6
7{ // generators: generate XPath queries from elements.
8 /*
9 * generators.getElementXPath(element)
10 * Get the XPath string for a given DOM element.
11 */
12 const xPath = generators.getElementXPath(domElement);
13 // /html/head/body/table/tr[2]/td/strong[@class='title']
14 console.log(xPath);
15
16
17 /*
18 * generators.getElementXPath(element, skipId)
19 * Get the fully qualified XPath string for a DOM element
20 * that has an ID, ignoring ID.
21 * e.g., `<html><body><div id='bob'></div></body></html>`
22 */
23 const xPath = generators.getElementXPath(
24 bobElement,
25 skipId = true
26 );
27 console.log(xPath); // /html/body/div[1]
28
29
30 const xPath = generators.getElementXPath(
31 bobElement,
32 skipId = false
33 );
34 console.log(xPath); // //*[@id='bob']
35
36
37 /*
38 * generators.getElementAttributes(element)
39 * Get all the HTML attributes on an element.
40 * This is exposed, but it is a support method for the XPath
41 * generator.
42 */
43 const attributes = generators.getElementAttributes(bobElement);
44 console.log(bobElement); // { id: 'bob' }
45}
46
47{ // evaluators: run XPath queries or CSS selectors to find elements
48 /*
49 * evaluators.getElementsByXPath(document, xpathQuery)
50 * Get elements by XPath query.
51 */
52 // element return type...
53 const elements = evaluators.getElementsByXPath(
54 document,
55 '/html/body/div'
56 );
57 console.log(elements); // [ DOMElement ]
58
59 // string return type...
60 const elements = evaluators.getElementsByXPath(
61 document,
62 '/html/body/div/text()'
63 );
64 console.log(elements); // [ "Hello world" ]
65
66 /*
67 * getElementsBySelector(document, rule)
68 * Get elements by CSS selector.
69 */
70 const elements = evaluators
71 .getElementsBySelector(
72 document,
73 'html > body > div#id'
74 );
75 console.log(elements); // [ DOMElement ]
76
77 /*
78 * evaluators.evaluateXPath(doc, xpath, contextNode, resultType)
79 * Execute a query on a document.
80 * e.g., <html><body><div id='bob'>Hello world</div></body></html>
81 */
82 const stringResult = evaluators.evaluateXPath(
83 document,
84 '/html/body/div',
85 document, // optional, defaults to the document
86 XPathResult.STRING_TYPE, // optional, defaults to ANY_TYPE.
87 );
88 console.log(stringResult); // "Hello world"
89}
90
91{ // cssToXPath: convert CSS queries to XPath queries
92 console.log(cssToXPath('html > body')); // //html>body
93}
94
95We have some tests that document this functionality as well. It should be possible to use our builds on the web as well, as they simply ignore the polyfills if they're already present.
License
As the code in this repository is derived from the Firebug source code, its BSD 3-clause license applies.
Development
I will accept pull requests which do not deviate from the intent of the original Firebug code, as the intent of this repository is simply to cleanup, standardize and package the Firebug XPath library for reuse.
- In general, readability will be preferred to conciseness.
- Please ensure all unit tests pass (
yarn test). - Please ensure new code has sufficient coverage (
yarn run coverage). - Please ensure code has been linted to meet the formatting standards (I use eslint-config-strawhouse and Prettier).
To build a web distribution, yarn run build should update the files in dist/.
No vulnerabilities found.
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: BSD 3-Clause "New" or "Revised" License: LICENSE:0
Reason
Found 0/27 approved changesets -- score normalized to 0
Reason
0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'master'
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 6 are checked with a SAST tool
Reason
78 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw
- Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25
- Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
- Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx
- Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4
- Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
- Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw
- Warn: Project is vulnerable to: GHSA-9vvw-cc9w-f27h
- Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c
- Warn: Project is vulnerable to: GHSA-hr2v-3952-633q
- Warn: Project is vulnerable to: GHSA-h6ch-v84p-w6p9
- Warn: Project is vulnerable to: GHSA-vh7m-p724-62c2
- Warn: Project is vulnerable to: GHSA-r9p9-mrjm-926w
- Warn: Project is vulnerable to: GHSA-434g-2637-qmqr
- Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m
- Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw
- Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p
- Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747
- Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh
- Warn: Project is vulnerable to: GHSA-4gmj-3p3h-gm8h
- Warn: Project is vulnerable to: GHSA-qrmc-fj45-qfc2
- Warn: Project is vulnerable to: GHSA-8r6j-v8pm-fqw3
- Warn: Project is vulnerable to: MAL-2023-462
- Warn: Project is vulnerable to: GHSA-xf7w-r453-m56c
- Warn: Project is vulnerable to: GHSA-qh2h-chj9-jffq
- Warn: Project is vulnerable to: GHSA-q42p-pg8m-cqh6
- Warn: Project is vulnerable to: GHSA-w457-6q6x-cgp9
- Warn: Project is vulnerable to: GHSA-62gr-4qp9-h98f
- Warn: Project is vulnerable to: GHSA-f52g-6jhx-586p
- Warn: Project is vulnerable to: GHSA-2cf5-4w76-r9qv
- Warn: Project is vulnerable to: GHSA-3cqr-58rm-57f8
- Warn: Project is vulnerable to: GHSA-g9r4-xpmj-mj65
- Warn: Project is vulnerable to: GHSA-q2c6-c6pm-g3gh
- Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44
- Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988
- Warn: Project is vulnerable to: GHSA-44pw-h2cw-w3vq
- Warn: Project is vulnerable to: GHSA-jp4x-w63m-7wgm
- Warn: Project is vulnerable to: GHSA-c429-5p7v-vgjp
- Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj
- Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37
- Warn: Project is vulnerable to: GHSA-4hpf-3wq7-5rpr
- Warn: Project is vulnerable to: GHSA-f522-ffg8-j8r6
- Warn: Project is vulnerable to: GHSA-2pr6-76vf-7546
- Warn: Project is vulnerable to: GHSA-8j8c-7jfh-h6hx
- Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
- Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
- Warn: Project is vulnerable to: GHSA-282f-qqgm-c34q
- Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
- Warn: Project is vulnerable to: GHSA-fvqr-27wr-82fm
- Warn: Project is vulnerable to: GHSA-4xc9-xhrj-v574
- Warn: Project is vulnerable to: GHSA-x5rq-j2xg-h7qm
- Warn: Project is vulnerable to: GHSA-jf85-cpcp-j695
- Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw
- Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9
- Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
- Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
- Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
- Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m
- Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
- Warn: Project is vulnerable to: GHSA-w9mr-4mfr-499f
- Warn: Project is vulnerable to: GHSA-6394-6h9h-cfjg
- Warn: Project is vulnerable to: GHSA-v62p-rq8g-8h59
- Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
- Warn: Project is vulnerable to: GHSA-6g33-f262-xjp4
- Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
- Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
- Warn: Project is vulnerable to: GHSA-4rq4-32rv-6wp6
- Warn: Project is vulnerable to: GHSA-64g7-mvw6-v9qj
- Warn: Project is vulnerable to: GHSA-2m39-62fm-q8r3
- Warn: Project is vulnerable to: GHSA-mf6x-7mm4-x2g7
- Warn: Project is vulnerable to: GHSA-j44m-qm6p-hp7m
- Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9
- Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh
- Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36
- Warn: Project is vulnerable to: GHSA-g7q5-pjjr-gqvp
- Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
- Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh
- Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp
Score
1.7
/10
Last Scanned on 2025-07-07
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More