Quiero crear una biblioteca usando Typescript. Esta biblioteca se puede usar dentro de los entornos de Nodo y navegador, por lo que la configuración proporciona soporte para ambos
(tsconfig.json)
{ "compilerOptions": { "baseUrl": ".", "declaration": true, "esModuleInterop": true, "lib": [ "esnext", "dom" ], "module": "commonjs", "outDir": "dist", "resolveJsonModule": true, "strict": true, "target": "es2019", }, "include": [ "./**/*.ts" ], "exclude": [ "./dist" ] }Estoy usando esbuild como paquete. El paquete.json contiene
{ "name": "my-lib", "version": "1.0.0", "main": "dist/index.js", "types": "dist/index.d.ts", "scripts": { "build": "tsc && esbuild ./dist/index.js --bundle --minify --sourcemap --outfile=./bundle/index.js" }, "dependencies": { "esbuild": "0.14.36" }, "devDependencies": { "typescript": "4.6.3" } }La biblioteca hace uso de algunas funciones de ayuda "privadas", estoy usando el siguiente código de muestra
import { TextEncoder } from 'util'; const encodeInput = function (input: string): Uint8Array { const textEncoder = new TextEncoder(); return textEncoder.encode(input); }Ejecutar el comando de secuencia de comandos de compilación arroja un error de esbuild que me dice que esto solo funciona para entornos de nodo, no en el navegador, lo cual tiene sentido porque
util https://nodejs.org/api/util.html#class-utiltextencoder¿Cómo puedo asegurarme de que esta biblioteca funcione en "ambos" mundos?
TextEncoder es global en Node, por lo que no necesita import . Úselo directamente, sin la declaración de import , como en el navegador.
Tampoco necesita crear una instancia de un nuevo
TextEncodercada vez que se invoca la función: es una pequeña optimización de rendimiento para crear una instancia una vez, y luego simplemente crear un alias para el método deencode. Vea abajo.
const encoder = new TextEncoder(); const encode = encoder.encode.bind(encoder); console.log(encode('hello world'));Puede utilizar la herramienta UMD (Universal Module Definition) para solucionar este problema.
En su tsconfig.json , simplemente cambie el module: "commonjs", al module: "umd", y debería construirse correctamente desde allí para funcionar en todos los entornos.