google-sr@6.0.0

[typicalninja]

This release introduces significant improvements to existing parsers, adds new parsing capabilities, and includes a range of internal and API-level changes that enhance the library's performance and usability.

View the full changelog

Special thanks to our new contributor @tresorama for their valuable contributions to this release!

Breaking changes

Replace Axios with native fetch by @typicalninja (#76)

We've removed the Axios dependency in favor of the native Fetch API. This change reduces bundle size and improves compatibility across environments, including modern runtimes like Deno and Bun.

The requestConfig option now uses the RequestOptions interface (extending RequestInit) instead of AxiosRequestConfig.

requestConfig: {
- params: { safe: "active" }
+ queryParams: { safe: "active" }
}

Rename CurrencyResult to UnitConversionResult by @typicalninja (#79)

The original CurrencyResult selector was found to work effectively for all types of conversion queries: currency, distance, weight, temperature, and more, not just currency conversions. This rename better captures its full functionality and provides a more accurate representation of its capabilities.

• CurrencyResult → UnitConversionResult
• CurrencyResultNode → UnitConversionResultNode
• ResultTypes.CurrencyResult → ResultTypes.UnitConversionResult

Rename strictSelector to noPartialResults by @typicalninja (#80)

The strictSelector option has been renamed to noPartialResults for improved clarity and to better describe its functionality. The behavior remains unchanged.

Parser and result type API renamed for clarity by @typicalninja (#85)

We've clarified the core API terminology to eliminate confusion and improve developer experience:

• ResultSelector → ResultParser
• resultTypes → parsers

This change better reflects the purpose of each component, improving readability and maintainability.

Improved type safety and parser consistency by @typicalninja (#92)

This release brings essential type improvements across all parsers. Key enhancements include:

• Proper generic inference with noPartialResults
• Required fields in result types now accurately reflect actual data.
• All empty strings are normalized to undefined (breaking change if you previously relied on empty string values)

OrganicResultNode.description is now optional by @typicalninja (#93)

In real-world search results, not all organic entries contain a description. To reflect this, the OrganicResultNode.description field is now explicitly optional and may be undefined.

Removed ResultNodeTyper helper by @typicalninja (#73)

The old ResultNodeTyper utility has been removed to simplify the typing model. You can now define custom result node types with a plain interface. This is primarily an internal change, but if you have custom selectors using this type, you'll need to update them.

- import { ResultNodeTyper } from 'google-sr'; 
- type MyCustomNode = ResultNodeTyper<"CUSTOM", 'link' | 'title'>; 

+ interface MyCustomNode { 
+    type: "CUSTOM"; 
+    link: string; 
+    title: string; 
+ }

What's new

Google News parser by @tresorama (#71)

Add support for parsing results from the Google News tab (tbm=nws).

import { NewsResult, search } from 'google-sr';

const results = await search({
	query: 'latest news on AI',
	parsers: [NewsResult],
	requestConfig: {
		queryParams: {
			tbm: 'nws', // Set tbm to nws for news results
		}
	}
});

Related Searches parser by @typicalninja (#96)

Adds support for parsing result from the "Related searches" section.

google-sr is now available on jsr.io

You can find it here: https://jsr.io/@typical/google-sr

Improvements

Add thumbnail URL parsing to NewsResult by @typicalninja (#89)

The NewsResult parser now extracts the thumbnail URL when available.

OrganicResult now includes source and isAd properties by @typicalninja (#90)

The OrganicResultNode now contains:

• source: A human-readable domain name for the result
• isAd: Boolean to detect whether a result is sponsored

Note: The isAd property implementation is based on reference data obtained through browser testing, as Google did not return sponsored ads during our automated testing with google-sr. If you encounter any issues with ad detection, please create an issue for help.

Other small fixes

Fixed delay option in searchWithPages by @typicalninja (#98)

The delay option in searchWithPages now functions correctly, applying the specified delay between paginated requests to prevent rate limiting issues.

Early exit optimization when noPartialResults is true by @typicalninja (#83)

When noPartialResults is enabled, parsers now exit immediately upon encountering unusable or empty data. This optimization prevents unnecessary processing when complete result properties are required.

Dependency maintenance

All dependencies and development dependencies have been updated to their latest stable versions.

CJS / ESM Notice

Starting in version 7.x (subject to change), we plan to publish ESM-only releases and remove the CJS build. As a result, you will no longer be able to use require() to import this package; you must use import instead.

If you're using Node.js v20 or later, you can still use require() with ESM modules natively. See release note

Check the readme for more information

---

Questions? Feedback? Open an issue or start a discussion.

View the full changelog • See all commits for this release

Like the project? Star it on GitHub ★

---

This discussion was created from the release google-sr@6.0.0.