sindresorhus · sindresorhus · Jan 22, 2024 · Jan 21, 2024 · Jan 21, 2024 · Jan 22, 2024
diff --git a/index.d.ts b/index.d.ts
@@ -41,7 +41,7 @@ declare namespace electronServe {
 	/**
 	Load the index file in the window.
 	*/
-	type loadURL = (window: BrowserWindow) => Promise<void>;
+	type loadURL = (window: BrowserWindow, searchParameters?: Record<string>) => Promise<void>;
 }
 
 /**

diff --git a/index.js b/index.js
@@ -72,7 +72,8 @@ module.exports = options => {
 		session.protocol.registerFileProtocol(options.scheme, handler);
 	});
 
-	return async window_ => {
-		await window_.loadURL(`${options.scheme}://${options.hostname}`);
+	return async (window_, searchParameters) => {
+		const qs = searchParameters ? '?' + new URLSearchParams(searchParameters).toString() : '';
+		await window_.loadURL(`${options.scheme}://${options.hostname}${qs}`);
 	};
 };
diff --git a/readme.md b/readme.md
@@ -28,6 +28,8 @@ let mainWindow;
 	mainWindow = new BrowserWindow();
 
 	await loadURL(mainWindow);
+	// Or optionally with query params
+	await loadURL(mainWindow, {id: 4, foo: 'bar'});
 
 	// The above is equivalent to this:
 	await mainWindow.loadURL('app://-');
@@ -79,6 +81,23 @@ Default: [`electron.session.defaultSession`](https://electronjs.org/docs/api/ses
 
 The [partition](https://electronjs.org/docs/api/session#sessionfrompartitionpartition-options) the protocol should be installed to, if you're not using Electron's default partition.
 
+### loadUrl(window, searchParams?)
+
+The `serve` function returns a `loadUrl` function, which you use to serve your HTML file in that window.
+
+##### window
+
+*Required*\
+Type: `BrowserWindow`\
+
+The window to load the file in.
+
+##### searchParameters
+
+Type: `object`\
+
+Key value pairs to set as the query parameters.
+
 ## Related
 
 - [electron-util](https://github.com/sindresorhus/electron-util) - Useful utilities for developing Electron apps and modules

diff --git a/test/fixture-search-params.js b/test/fixture-search-params.js
@@ -0,0 +1,15 @@
+'use strict';
+const {app, BrowserWindow} = require('electron');
+const {join} = require('path');
+const serve = require('..');
+
+const loadUrl = serve({directory: join(__dirname, 'sub')});
+
+let mainWindow;
+
+(async () => {
+	await app.whenReady();
+
+	mainWindow = new BrowserWindow();
+	loadUrl(mainWindow, {id: 4, foo: 'bar'});
+})();
diff --git a/test/index 2.html b/test/index 2.html
@@ -0,0 +1,9 @@
+<!doctype html>
+<html>
+	<head>
+		<meta charset="utf-8">
+	</head>
+	<body>
+		<h1>🚀</h1>
+	</body>
+</html>
diff --git a/test/sub/index.html b/test/sub/index.html
@@ -0,0 +1,15 @@
+<!doctype html>
+<html>
+	<head>
+		<meta charset="utf-8">
+		<script>
+			const urlParams = new URLSearchParams(window.location.search);
+			const id = urlParams.get('id');
+			const foo = urlParams.get('foo');
+			document.getElementById('params').innerHTML = `${id}${foo}`;
+		</script>
+	</head>
+	<body>
+		<h1 id="params"></h1>
+	</body>
+</html>
diff --git a/test/test.js b/test/test.js
@@ -65,3 +65,15 @@ test('throws error if unresolved path has an extension other than .html', async
 	await t.throwsAsync(client.waitUntilTextExists('h1', '🦄', 5000));
 	t.pass();
 });
+
+test('serves directory index with search params', async t => {
+	t.context.spectron = new Application({
+		path: electron,
+		args: ['fixture-search-params.js']
+	});
+	await t.context.spectron.start();
+	const {client} = t.context.spectron;
+	await client.waitUntilWindowLoaded();
+	await client.waitUntilTextExists('h1', '4bar', 5000);
+	t.pass();
+});