Deno TypeScript avec Claude Code

Optimiser le développement Deno avec Claude Code

Deno est un runtime moderne axé sur la sécurité. Il supporte nativement TypeScript et fournit un environnement d’exécution sécurisé grâce à son modèle de permissions. Combiné à Claude Code, vous pouvez exploiter rapidement les fonctionnalités uniques de Deno.

Configuration initiale du projet

> Crée une application web avec Deno.
> Utilise le framework Fresh et configure le deno.json.

// deno.json
{
  "lock": false,
  "tasks": {
    "dev": "deno run -A --watch=static/,routes/ dev.ts",
    "build": "deno run -A dev.ts build",
    "start": "deno run -A main.ts",
    "test": "deno test -A --coverage=coverage",
    "lint": "deno lint",
    "fmt": "deno fmt"
  },
  "imports": {
    "$fresh/": "https://deno.land/x/[email protected]/",
    "$std/": "https://deno.land/[email protected]/",
    "preact": "https://esm.sh/[email protected]",
    "preact/": "https://esm.sh/[email protected]/"
  },
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "preact"
  }
}

Exploitation du modèle de permissions

Deno refuse tous les accès par défaut.

> Crée un serveur API qui n'autorise que la lecture de fichiers
> et l'accès réseau. Configure selon le principe du moindre privilège.

// server.ts
// Exécution : deno run --allow-net=:8000 --allow-read=./data server.ts

import { serve } from "$std/http/server.ts";

const handler = async (req: Request): Promise<Response> => {
  const url = new URL(req.url);

  if (url.pathname === "/api/config") {
    const data = await Deno.readTextFile("./data/config.json");
    return new Response(data, {
      headers: { "content-type": "application/json" },
    });
  }

  if (url.pathname === "/api/items") {
    const dir = Deno.readDir("./data/items");
    const items = [];
    for await (const entry of dir) {
      if (entry.isFile && entry.name.endsWith(".json")) {
        const content = await Deno.readTextFile(
          `./data/items/${entry.name}`
        );
        items.push(JSON.parse(content));
      }
    }
    return Response.json(items);
  }

  return new Response("Not Found", { status: 404 });
};

serve(handler, { port: 8000 });

Architecture en îlots avec Fresh

> Crée un compteur comme composant îlot de Fresh.
> Tiens compte de la séparation entre côté serveur et côté client.

// routes/index.tsx
import Counter from "../islands/Counter.tsx";

export default function Home() {
  return (
    <div class="max-w-screen-md mx-auto p-4">
      <h1 class="text-4xl font-bold">Application Deno Fresh</h1>
      <Counter start={0} />
    </div>
  );
}

// islands/Counter.tsx
import { useSignal } from "@preact/signals";

interface CounterProps {
  start: number;
}

export default function Counter({ start }: CounterProps) {
  const count = useSignal(start);
  return (
    <div class="flex gap-4 items-center">
      <button onClick={() => count.value--}>-</button>
      <span class="text-2xl">{count}</span>
      <button onClick={() => count.value++}>+</button>
    </div>
  );
}

Tests et couverture

// server_test.ts
import { assertEquals } from "$std/assert/assert_equals.ts";

Deno.test("Vérification de santé de l'API", async () => {
  const res = await fetch("http://localhost:8000/api/config");
  assertEquals(res.status, 200);
  const data = await res.json();
  assertEquals(typeof data, "object");
});

Deno.test("Opérations fichier avec permissions", async () => {
  const content = await Deno.readTextFile("./data/config.json");
  const config = JSON.parse(content);
  assertEquals(config.version !== undefined, true);
});

Déploiement sur Deno Deploy

# CLI de Deno Deploy
deno install -A jsr:@deno/deployctl

# Déploiement
deployctl deploy --project=my-app --entrypoint=main.ts

Résumé

Le modèle de sécurité de Deno et son support natif de TypeScript offrent une expérience de développement sûre et confortable. Avec Claude Code, vous pouvez aussi maîtriser efficacement la configuration des permissions et les patterns spécifiques de Fresh. Consultez aussi les astuces de développement TypeScript et le guide d’audit de sécurité.

Pour plus de détails sur Deno, consultez la documentation officielle de Deno.