feat: add RemoveHidden option to strip display:none elements before extraction
All checks were successful
CI / vet (pull_request) Successful in 34s
CI / test (pull_request) Successful in 1m1s
CI / build (pull_request) Successful in 1m5s

When RemoveHidden is true, JavaScript is evaluated on the live page to
remove all elements with computed display:none before readability
extraction. This defends against anti-scraping honeypots that embed
prompt injections in hidden DOM elements.

The implementation uses an optional pageEvaluator interface so that the
concrete document (backed by Playwright) supports it while the Document
interface remains unchanged.

Closes #62

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-20 14:06:17 +00:00
parent c1a5814732
commit 65cf6b027f
3 changed files with 164 additions and 0 deletions

View File

@@ -18,8 +18,35 @@ type ReadabilityOptions struct {
// infinite-scroll content, related articles, or other elements that
// pollute the extracted article.
RemoveSelectors []string
// RemoveHidden, when true, evaluates JavaScript on the live page to remove
// all elements whose computed display is "none" before extracting content.
// This is useful for stripping anti-scraping honeypots that hide prompt
// injections in invisible DOM elements.
//
// Note: this modifies the live page DOM. The Document must support
// page-level JavaScript evaluation (the concrete document type returned
// by Browser.Open does). If the Document does not support evaluation,
// an error is returned.
RemoveHidden bool
}
// pageEvaluator is an optional interface that Document implementations can
// satisfy to support page-level JavaScript evaluation.
type pageEvaluator interface {
PageEvaluate(expression string) (interface{}, error)
}
// removeHiddenJS is the JavaScript snippet that removes all elements with
// computed display:none from the DOM.
const removeHiddenJS = `() => {
document.querySelectorAll('*').forEach(el => {
if (el.isConnected && window.getComputedStyle(el).display === 'none') {
el.remove();
}
});
}`
// Readability extracts article content from a document using the readability algorithm.
func Readability(_ context.Context, doc Document) (Article, error) {
return ReadabilityWithOptions(context.Background(), doc, ReadabilityOptions{})
@@ -29,6 +56,18 @@ func Readability(_ context.Context, doc Document) (Article, error) {
// the provided options before extraction. Use RemoveSelectors to strip
// elements (e.g. infinite-scroll articles) from the DOM before parsing.
func ReadabilityWithOptions(_ context.Context, doc Document, opts ReadabilityOptions) (Article, error) {
// RemoveHidden must run on the live page before we snapshot the HTML,
// because computed styles are only available via JavaScript.
if opts.RemoveHidden {
pe, ok := doc.(pageEvaluator)
if !ok {
return Article{}, fmt.Errorf("RemoveHidden requires a Document that supports page-level JavaScript evaluation")
}
if _, err := pe.PageEvaluate(removeHiddenJS); err != nil {
return Article{}, fmt.Errorf("failed to remove hidden elements: %w", err)
}
}
data, err := doc.Content()
if err != nil {
return Article{}, err