Build: ein Hilfspaket mit eigenen Tests

// Turns a title into a URL slug: "Tea & Cake!" -> "tea-cake".
export function slugify(text) {
  return text.toLowerCase();
}

console.log(slugify("Tea & Cake!"));

import {test} from 'node:test';
import assert from 'node:assert/strict';
import {slugify} from './main.js';

test('Tea & Cake! wird zu tea-cake', () => {
  assert.equal(slugify('Tea & Cake!'), 'tea-cake', `slugify('Tea & Cake!') lieferte ${JSON.stringify(slugify('Tea & Cake!'))}`);
});

test('Folgen von Leer- und Satzzeichen werden ein Bindestrich, keiner an den Enden', () => {
  const got = slugify('  Hello,   World  ');
  assert.equal(got, 'hello-world', `slugify('  Hello,   World  ') lieferte ${JSON.stringify(got)}`);
});

test('Ziffern bleiben', () => {
  assert.equal(slugify('Top 10 Tips'), 'top-10-tips', `slugify('Top 10 Tips') lieferte ${JSON.stringify(slugify('Top 10 Tips'))}`);
});

test('Akzente fallen weg: Crème Brûlée wird zu creme-brulee', () => {
  const got = slugify('Crème Brûlée');
  assert.equal(got, 'creme-brulee', `slugify('Crème Brûlée') lieferte ${JSON.stringify(got)}`);
});

test('ein Wert, der kein String ist, wirft einen TypeError', () => {
  assert.throws(() => slugify(42), TypeError, 'slugify(42) sollte einen TypeError werfen');
});

{
  "type": "module"
}

// Shortens text to at most max characters, ending with an ellipsis: "A long…".
export const ELLIPSIS = "…";

export function truncate(text, max) {
  return text;
}

console.log(truncate("A long title", 7));

import {test} from 'node:test';
import assert from 'node:assert/strict';
import {truncate} from './main.js';

test('Text, der passt, kommt unverändert zurück', () => {
  assert.equal(truncate('Tea', 5), 'Tea', `truncate('Tea', 5) lieferte ${JSON.stringify(truncate('Tea', 5))}`);
  assert.equal(truncate('Hello', 5), 'Hello', `truncate('Hello', 5) lieferte ${JSON.stringify(truncate('Hello', 5))}`);
});

test('langer Text endet mit …: truncate("A long title", 7) ist "A long…"', () => {
  const got = truncate('A long title', 7);
  assert.equal(got, 'A long…', `truncate('A long title', 7) lieferte ${JSON.stringify(got)}`);
});

test('kein Leerzeichen vor dem …: truncate("Hello world", 7) ist "Hello…"', () => {
  const got = truncate('Hello world', 7);
  assert.equal(got, 'Hello…', `truncate('Hello world', 7) lieferte ${JSON.stringify(got)}`);
});

test('das Ergebnis ist nie länger als max', () => {
  for (let max = 1; max <= 12; max++) {
    const got = truncate('A long title here', max);
    assert.ok(got.length <= max, `truncate('A long title here', ${max}) lieferte ${JSON.stringify(got)}, ${got.length} Zeichen`);
  }
});

test('ein max, das keine ganze Zahl ab 1 ist, wirft einen RangeError', () => {
  assert.throws(() => truncate('Tea', 0), RangeError, 'truncate("Tea", 0) sollte einen RangeError werfen');
  assert.throws(() => truncate('Tea', 2.5), RangeError, 'truncate("Tea", 2.5) sollte einen RangeError werfen');
});

test('text, der kein String ist, wirft einen TypeError', () => {
  assert.throws(() => truncate(null, 5), TypeError, 'truncate(null, 5) sollte einen TypeError werfen');
});

{
  "type": "module"
}

// The entry file of textkit: what it exports is the package.
export * from "./slug.js";
export * from "./truncate.js";

import {test} from 'node:test';
import assert from 'node:assert/strict';
import * as textkit from './main.js';

test('exportiert slugify und truncate und sonst nichts', () => {
  const names = Object.keys(textkit).sort();
  assert.deepEqual(names, ['slugify', 'truncate'], `der Einstieg exportiert ${JSON.stringify(names)}`);
});

test('die Funktionen arbeiten über die Einstiegsdatei', () => {
  assert.equal(textkit.slugify('Tea & Cake!'), 'tea-cake', 'slugify über den Einstieg sollte tea-cake liefern');
  assert.equal(textkit.truncate('A long title', 7), 'A long…', 'truncate über den Einstieg sollte A long… liefern');
});

test('hat keinen Default-Export', () => {
  assert.equal('default' in textkit, false, 'der Einstieg sollte nur benannte Exporte haben');
});

// Turns a title into a URL slug: "Tea & Cake!" -> "tea-cake".
export function slugify(text) {
  if (typeof text !== "string") throw new TypeError("slugify expects a string, got " + typeof text);
  return text
    .normalize("NFD")
    .replace(/[\u0300-\u036f]/g, "")
    .toLowerCase()
    .replace(/[^a-z0-9]+/g, "-")
    .replace(/^-+|-+$/g, "");
}

// Shortens text to at most max characters, ending with an ellipsis: "A long…".
export const ELLIPSIS = "…";

export function truncate(text, max) {
  if (typeof text !== "string") throw new TypeError("truncate expects a string, got " + typeof text);
  if (!Number.isInteger(max) || max < 1) throw new RangeError("max must be a whole number from 1, got " + max);
  if (text.length <= max) return text;
  return text.slice(0, max - 1).trimEnd() + ELLIPSIS;
}

{
  "type": "module"
}