unprint 0.18.28 → 0.18.30

package/README.md

@@ -233,6 +233,7 @@ Options
 * `userAgent`: The default user agent header
 * `browserUserAgent`: The default user agent header for browser-like requests (`get` interface `fetch` and `browserRequest`)
 * `apiUserAgent`: The default user agent header for raw requests (`get` interface `request`)
+* `useBrowser`: Forward the call to `unprint.browser()` (see below), only for GET-requests
 
 Use Playwright with Chromium (experimental)
 * `unprint.browser(url, [options])`
@@ -270,6 +271,17 @@ Returns
 }
 ```
 
+### Helpers
+* `initialize(source, [selector], [options])` (`init`): Initialize element or HTML as unprint context
+* `initializeAll(source, [selector], [options])` (`initAll`): Initialize element or HTML as multiple contexts
+* `extractDate(string, [format], [options])`: Parse date with moment and some curation
+* `extractDateAgo(string, [options])`: Extract relative date (e.g. 4 months ago)
+* `extractDuration(timestamp, [matchRegex])`: Parse duration (e.g. 04:11:05) to seconds
+* `extractTimestamp(string)`: Parse timestamp (e.g. 4H11M5S) to seconds
+* `extractNumber(string, [options])`: Parse string as number
+* `extractSourceSet(string, [options])`: Parse source set to object
+* `formatDate(date, format, inputFormat)`: Format date with moment
+
 ### Proxy
 ```javascript
 unprint.options({ // or unprint.options();
@@ -299,7 +311,11 @@ Usage:
 * `unprint.off('trigger', callbackFn)`
 
 Triggers:
+* `query`: A query method was used
 * `requestInit`: A HTTP request is about to be made
 * `requestSuccess`: The HTTP request completed with an OK status code
 * `requestError`: The HTTP request completed with an error status code
-* `query`: A query method was used
+* `browserOpen`: A browser window was launched or used
+* `browserClose`: A browser window was closed
+* `controlSuccess`: A browser call control method succeeded
+* `controlError`: A browser call control method failed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unprint",
-  "version": "0.18.28",
+  "version": "0.18.30",
   "description": "Simplify common web scraping tasks while staying in control of the data.",
   "main": "src/app.js",
   "scripts": {},

package/src/app.js

@@ -1426,6 +1426,11 @@ async function browserRequest(url, customOptions = {}) {
 
 				await closeBrowser(client, options);
 
+				events.emit('controlError', {
+					...feedbackBase,
+					error,
+				});
+
 				return {
 					ok: false,
 					controlError: error.message,
@@ -1503,6 +1508,10 @@ async function request(url, body, customOptions = {}, method = 'GET', redirects
 		url,
 	}, globalOptions, customOptions]);
 
+	if (options.useBrowser) {
+		return browserRequest(url, options);
+	}
+
 	const { limiter, interval, concurrency } = getLimiter(url, options);
 
 	const agent = getAgent(options, url);
@@ -1624,6 +1633,7 @@ module.exports = {
 	extractDateAgo,
 	extractDuration,
 	extractNumber,
+	extractSourceSet,
 	extractTimestamp,
 	formatDate,
 	dateConstants: {