Goja bindings for HTML parsing inspired by Cheerio.
package main
import (
"github.com/dop251/goja"
"github.com/5rahim/gojadoc"
)
func main() {
vm := goja.New()
err := gojadoc.BindDocument(vm)
if err != nil {
panic(err)
}
}const html = `
<body>
<section id="content">
<article class="post" data-id="1">
<h2>First Post</h2>
<p>This is the first post.</p>
<a href="https://example.com/first-post" class="read-more">Read more</a>
</article>
<article class="post" data-id="2">
<h2>Second Post</h2>
<p>This is the second post.</p>
<a href="https://example.com/second-post" class="read-more">Read more</a>
</article>
<article class="post" data-id="3">
<h2>Third Post</h2>
<p>This is the third post.</p>
<a href="https://example.com/third-post" class="read-more">Read more</a>
</article>
</section>
</body>
</html>`
const $ = new Doc(html)
const titles = $.find("section")
.children("article.post")
.filter((i, e) => {
return e.attr("data-id") !== "1"
})
.map((i, e) => {
return e.children("h2").text()
})// doc.d.ts
declare class DocSelection {
// Retrieves the value of the specified attribute for the first element in the DocSelection.
// To get the value for each element individually, use a looping construct such as each or map.
attr(name: string): string | undefined;
// Returns an object containing the attributes of the first element in the DocSelection.
attrs(): { [key: string]: string };
// Gets the child elements of each element in the DocSelection, optionally filtered by a selector.
children(selector?: string): DocSelection;
// For each element in the DocSelection, gets the first ancestor that matches the selector by testing the element itself
// and traversing up through its ancestors in the DOM tree.
closest(selector?: string): DocSelection;
// Gets the children of each element in the DocSelection, including text and comment nodes.
contents(): DocSelection;
// Gets the children of each element in the DocSelection, filtered by the specified selector.
contentsFiltered(selector: string): DocSelection;
// Gets the value of a data attribute for the first element in the DocSelection.
// If no name is provided, returns an object containing all data attributes.
data<T extends string | undefined>(name?: T): T extends string ? (string | undefined) : { [key: string]: string };
// Iterates over each element in the DocSelection, executing a function for each matched element.
each(callback: (index: number, element: DocSelection) => void): DocSelection;
// Ends the most recent filtering operation in the current chain and returns the set of matched elements to its previous state.
end(): DocSelection;
// Reduces the set of matched elements to the one at the specified index. If a negative index is given, it counts backwards starting at the end
// of the set.
eq(index: number): DocSelection;
// Filters the set of matched elements to those that match the selector.
filter(selector: string | ((index: number, element: DocSelection) => boolean)): DocSelection;
// Gets the descendants of each element in the DocSelection, filtered by a selector.
find(selector: string): DocSelection;
// Reduces the set of matched elements to the first element in the DocSelection.
first(): DocSelection;
// Reduces the set of matched elements to those that have a descendant that matches the selector.
has(selector: string): DocSelection;
// Gets the combined text contents of each element in the DocSelection, including their descendants.
text(): string;
// Gets the HTML contents of the first element in the DocSelection.
html(): string | null;
// Checks the set of matched elements against a selector and returns true if at least one of these elements matches.
is(selector: string | ((index: number, element: DocSelection) => boolean)): boolean;
// Reduces the set of matched elements to the last element in the DocSelection.
last(): DocSelection;
// Gets the number of elements in the DocSelection.
length(): number;
// Passes each element in the current matched set through a function, producing an array of the return values.
map<T>(callback: (index: number, element: DocSelection) => T): T[];
// Gets the next sibling of each element in the DocSelection, optionally filtered by a selector.
next(selector?: string): DocSelection;
// Gets all following siblings of each element in the DocSelection, optionally filtered by a selector.
nextAll(selector?: string): DocSelection;
// Gets the next siblings of each element in the DocSelection, up to but not including the element matched by the selector.
nextUntil(selector: string, until?: string): DocSelection;
// Removes elements from the DocSelection that match the selector.
not(selector: string | ((index: number, element: DocSelection) => boolean)): DocSelection;
// Gets the parent of each element in the DocSelection, optionally filtered by a selector.
parent(selector?: string): DocSelection;
// Gets the ancestors of each element in the DocSelection, optionally filtered by a selector.
parents(selector?: string): DocSelection;
// Gets the ancestors of each element in the DocSelection, up to but not including the element matched by the selector.
parentsUntil(selector: string, until?: string): DocSelection;
// Gets the previous sibling of each element in the DocSelection, optionally filtered by a selector.
prev(selector?: string): DocSelection;
// Gets all preceding siblings of each element in the DocSelection, optionally filtered by a selector.
prevAll(selector?: string): DocSelection;
// Gets the previous siblings of each element in the DocSelection, up to but not including the element matched by the selector.
prevUntil(selector: string, until?: string): DocSelection;
// Gets the siblings of each element in the DocSelection, optionally filtered by a selector.
siblings(selector?: string): DocSelection;
}
declare class Doc extends DocSelection {
constructor(html: string);
}
declare function LoadDoc(html: string): DocSelectionFunction;
declare interface DocSelectionFunction {
(selector: string): DocSelection;
}