Merge pull request #14 from krutoo/url-utils

url-utils

deno.json

@@ -8,13 +8,15 @@
   "imports": {
     "@deno/dnt": "jsr:@deno/dnt@^0.41.0",
     "@std/assert": "jsr:@std/assert@^0.220.1",
+    "@std/expect": "jsr:@std/expect@^1.0.5",
     "@std/testing": "jsr:@std/testing@^0.220.1"
   },
   "exports": {
     ".": "./src/mod.ts",
     "./middleware": "./src/middleware/mod.ts",
     "./response": "./src/response.ts",
-    "./server": "./src/server.ts"
+    "./server": "./src/server.ts",
+    "./url": "./src/url/mod.ts"
   },
   "fmt": {
     "lineWidth": 100,

scripts/build-npm.ts

@@ -17,6 +17,10 @@ await build({
       name: './server',
       path: './src/server.ts',
     },
+    {
+      name: './url',
+      path: './src/url/mod.ts',
+    },
   ],
   outDir: './npm',
   shims: {
@@ -40,8 +44,7 @@ await build({
   compilerOptions: {
     lib: ['ES2022', 'DOM', 'DOM.Iterable'],
   },
-  async postBuild() {
-    await Deno.copyFile('README.md', './npm/README.md');
-    await Deno.copyFile('LICENSE', './npm/LICENSE');
-  },
 });
+
+await Deno.copyFile('README.md', './npm/README.md');
+await Deno.copyFile('LICENSE', './npm/LICENSE');

src/url/__test__/url.test.ts

@@ -0,0 +1,57 @@
+import { describe } from '@std/testing/bdd';
+import { expect } from '@std/expect';
+import { resetParams, setParams, withoutParams, withParams } from '../url.ts';
+
+describe('withParams', () => {
+  const input = new URL('http://hello.com?foo=1&bar=2');
+
+  expect(input.searchParams.get('foo')).toBe('1');
+  expect(input.searchParams.get('bar')).toBe('2');
+
+  const output = withParams(input, { foo: null, bar: 3, baz: 4 });
+
+  expect(output.searchParams.get('foo')).toBe(null);
+  expect(output.searchParams.get('bar')).toBe('3');
+  expect(output.searchParams.get('baz')).toBe('4');
+});
+
+describe('withoutParams', () => {
+  const input = new URL('http://hello.com?foo=1&bar=2');
+
+  expect(input.searchParams.get('foo')).toBe('1');
+  expect(input.searchParams.get('bar')).toBe('2');
+
+  const output = withoutParams(input);
+
+  expect(output.searchParams.get('foo')).toBe(null);
+  expect(output.searchParams.get('bar')).toBe(null);
+  expect(output.searchParams.get('baz')).toBe(null);
+});
+
+describe('setParams', () => {
+  const input = new URL('http://hello.com?foo=1&bar=2');
+
+  expect(input.searchParams.get('foo')).toBe('1');
+  expect(input.searchParams.get('bar')).toBe('2');
+
+  const output = setParams(input, { foo: null, bar: 3, baz: 4 });
+
+  expect(Object.is(input, output)).toBe(true);
+  expect(output.searchParams.get('foo')).toBe(null);
+  expect(output.searchParams.get('bar')).toBe('3');
+  expect(output.searchParams.get('baz')).toBe('4');
+});
+
+describe('resetParams', () => {
+  const input = new URL('http://hello.com?foo=1&bar=2');
+
+  expect(input.searchParams.get('foo')).toBe('1');
+  expect(input.searchParams.get('bar')).toBe('2');
+
+  const output = resetParams(input);
+
+  expect(Object.is(input, output)).toBe(true);
+  expect(input.searchParams.get('foo')).toBe(null);
+  expect(input.searchParams.get('bar')).toBe(null);
+  expect(input.searchParams.get('baz')).toBe(null);
+});

src/url/mod.ts

@@ -0,0 +1,2 @@
+export * from './url.ts';
+export * from './types.ts';

src/url/types.ts

@@ -0,0 +1 @@
+export type URLSearchParamsInit = Record<string, unknown>;

src/url/url.ts

@@ -0,0 +1,55 @@
+import type { URLSearchParamsInit } from './types.ts';
+
+/**
+ * Получив параметры применит их к переданному URL.
+ * @param url URL.
+ * @param params Параметры.
+ */
+export function setParams(url: URL, params: URLSearchParamsInit): URL {
+  for (const [paramName, paramValue] of Object.entries(params)) {
+    if (paramValue === null) {
+      url.searchParams.delete(paramName);
+      continue;
+    }
+
+    if (paramValue !== undefined) {
+      url.searchParams.set(paramName, String(paramValue));
+      continue;
+    }
+  }
+
+  return url;
+}
+
+export function resetParams(url: URL): URL {
+  url.search = '';
+  return url;
+}
+
+/**
+ * Получив URL и параметры вернет новый URL с примененными параметрами.
+ * @param url URL.
+ * @param params Параметры.
+ * @return URL.
+ */
+export function withParams(url: string | URL, params: URLSearchParamsInit): URL {
+  return setParams(new URL(url), params);
+}
+
+/**
+ * Получив URL вернет его копию но без параметров.
+ * @param url URL.
+ * @return URL.
+ */
+export function withoutParams(url: string | URL): URL {
+  return resetParams(new URL(url));
+}
+
+export const URLUtil = {
+  setParams,
+  resetParams,
+  withParams,
+  withoutParams,
+};
+
+export default URLUtil;