Novidades do Deno 1.40

O Deno chegou na versão 1.40 e essa é uma das versões mais legais de todas! Primeiro, porque ela tem a adição da Temporal API que eu estou falando aqui desde 2020! E eu acho que é o primeiro runtime a implementar essa funcionalidade de fato!

Além disso, uma série de outras novidades que eu vou passar por aqui uma por uma!

Temporal API#

A temporal API é a nova forma de lidar com as datas no JavaScript, eu falei muito sobre ela neste artigo e mostrei todos os detalhes, então não vou entrar em muitos detalhes aqui, mas essencialmente, o Deno é o primeiro runtime que implementa essa API completamente.

Ela ainda está por trás de uma flag --unstable-temporal mas você já pode utilizar da mesma forma que a documentação oficial informa! Se você rodar um terminal com deno --unstable-temporal, você já pode fazer alguns testes:

1
console.log(Temporal.Now.instant()) // data e hora de hoje
2
console.log(Temporal.Now.zonedDateTimeISO()) // equivalente ao toISOString
3
const birthday = Temporal.PlainMonthDay.from("12-15");
4
const birthdayIn2030 = birthday.toPlainDate({ year: 2030 });
5
console.log(birthdayIn2030.toString()); // 2030-12-15

Import.meta.filename e dirname#

Isso aqui era algo que eu queria muito que acontecesse. Desde o advento dos ECMAScript modules, toda a forma de resolução de módulos mudou, o que significa que pegar o nome de um arquivo ou o diretório onde ele existe não são mais tão simples de buscar.

No Node, temos duas variáveis “mágicas” chamadas __dirname e __filename que retornam respectivamente o caminho do diretório e do arquivo que você está executando.

Mas com ESM não podemos usá-las porque elas não são setadas no início da aplicação, então temos que buscar a URL do módulo com import.meta.url, que retorna uma fileURL no modelo file://caminho, e ai temos que usar dirname nessa URL, mas apenas depois de converter essa URL para um caminho!

1
import { fileURLToPath } from 'node:url'
2
import { dirname } from 'node:path'
3

4
const fileurl = import.meta.url
5
const path = fileURLToPath(fileurl)
6
const dir = dirname(path)
7
const filename = path.split('/').pop()
8

9
console.log({ fileurl, path, dir, filename })
10
/*
11
{
12
  fileurl: "file:///Users/lucas/repos/deno/teste.ts",
13
  path: "/Users/lucas/repos/deno/teste.ts",
14
  dir: "/Users/lucas/repos/deno",
15
  filename: "teste.ts"
16
}
17
*/

Isso era muito chato! Especialmente se você tinha que lidar com caminhos constantemente, então duas propostas foram adicionadas para poder suportar tanto o arquivo quanto a pasta, chamadas import.meta.filename e import.meta.dirname, agora você pode substituir tudo isso por:

1
console.log(import.meta.dirname) // /Users/lucas/repos/deno
2
console.log(import.meta.filename) // /Users/lucas/repos/deno/teste.ts

Decorators#

Finalmente vamos ter suporte nativo a decorators, uma proposta que está no estágio final e deve chegar nos browsers logo mais! Depois de mais de 5 anos em espera, a nova proposta junta todas as propostas anteriores em uma só.

Um exemplo clássico que a gente pode dar é o @trace que serve para debugar qualquer função colocando um console antes e depois da execução:

1
function trace(fn: any, ctx: ClassMethodDecoratorContext) {
2
  return function (...args: unknown[]) {
3
    console.log("ENTERED", ctx.name);
4
    const v = fn(...args);
5
    console.log("EXITED", ctx.name);
6
    return v;
7
  };
8
}
9

10
class App {
11
  @trace
12
  static start() {
13
    console.log("Hello World!");
14
  }
15
}
16

17
App.start();

Imports mais simples#

Essa é outra novidade interessante. Antigamente, quando tínhamos import maps com módulos que tinham subdiretórios, tínhamos que definir dois imports diferentes:

1
{
2
  "imports": {
3
    "preact": "npm:preact@10.5.13",
4
    "preact/": "npm:/preact@10.5.13/"
5
  }
6
}

Isso permitia que a gente pudesse importar tanto o top-level preact com import preact from 'preact', e também os submódulos tipo import hooks from 'preact/hooks'.

Agora a simplificação funciona para que você possa só ter um módulo no import map e consiga importar tudo da mesma raiz só com um map:

1
{
2
  "imports": {
3
    "preact": "npm:preact@10.5.13"
4
  }
5
}

Embora eu não goste muito de usar import maps e prefira a abordagem de um arquivo deps.ts

Outras mudanças#

• Uma série de APIs e comandos estão sendo depreciados, em especial o deno.run e deno.serveHttp
• Suporte ao rejectionHandled, um evento que é disparado sempre que uma exception acontece em uma promise que já foi rejeitada (quando você tem um catch não usado)
• Suporte a janelas com WebGPU
• Suporte a novas APIs nativas do Node.js
• Melhores mensagens no deno lint e deno doc