daniel @ posixtronic

JavaScript: promises, thenables, async/await

2021-05-02T00:00:00+00:00

A JavaScript é a linguagem do frontend da Web, um ambiente com frequentes operações de IO e computações paralelas. A programação assíncrona é bastante comum em aplicações JavaScript. Apresento recursos de assincronismo da JS acompanhados de exemplos elementares de sua utilização.

Promessas
Thenables
Async
Await
Ver também

Promessas

Promessas são objetos que quando resolvidos retornam um valor para a condição de sucesso ou outro para uma de falha. Dessa forma uma promessa é um objeto que possui um estado e um valor e que está associado a métodos que o resolvem ou o rejeitam.

// cria um objeto p do tipo promessa
const p = new Promise((resolve, reject) => {
    // resolve a promessa retornando um valor aleatório de par ou ímpar
    try {
        if ( Math.random() >= 0.5) {
            resolve("Par")
        }
        else {
            resolve("Ímpar")
        }
    //  rejeita a promessa em caso de erro
    } catch (e) {
        reject(e)
    }
}) 

Thenables

Um thenable é um objeto com o método then(onFullfiled[, onRejected]). Toda promessa é um thenable e como o método retorna uma promessa, ele é utilizado para encadear operações.

Outros métodos são o catch(onRejected) e o finally(onSettled). Onde catch(onCatch) é equivalente a then(onThen, onCatch) e finally(onFinally) é equivalente a then(onFinally, onFinally).

Nota: As funções ‘on…’ não são built-ins mas identificadores arbitrários que escolhi para representar os respectivos callbacks.

// Requisita a URL e passa o texto da página para uma função callback
let url = "https://www.google.com/robots.txt" 
fetch(url)
    .then(req => req.text())
    .then(callback)

Nota: Devido à política de CORS dos navegadores. Solicitações de recursos em endereços externos ao domínio da página são bloqueados. Em outras palavras, você precisa estar em site.com para solicitar um recurso em site.com.

O callback, um pedaço de código executável que é passado como argumento e executado futuramente, é a essência da programaçao assíncrona. No caso um callback é uma função que é passada como argumento para o método .then() e executada tendo o valor contido na promessa passado como argumento.

O callback é uma função qualquer que não seja um método. A exemplo:

// Armazena e imprime o texto da página
function printText(cb) {
    let text = cb
    console.log(text)
}

let url = "https://www.google.com/robots.txt" 
fetch(url)
    .then(req => req.text())
    // imprime o texto da página
    .then(printText)
    // imprime um eventual erro
    .catch(console.log) 

Async

O async é uma palavra-chave que faz com que a função seja executada sem bloqueio.

A invocação da função não cria uma promessa todavia o seu retorno, caso não seja uma promessa, é embrulhado como uma promessa resolvida. E caso não haja retorno, ela retorna uma promessa resolvida cujo valor é indefinido.

// retorna uma promessa resolvida cuja valor é 0
async function nihil() {
    return 0
}

Await

O await aguarda a resolução de uma promessa. Ele pausa a execução da função até que a promessa seja resolvida ou recusada e desembrulha uma promessa resolvida. Se o async é o yin, o await é o yang.

Ele não é sempre necessário mas é utilizado para evitar uma condição de corrida ou para desembrulhar uma promessa. A restrição é que ele apenas pode ser utilizado dentro de uma função async.

// Aguarda 1s e imprime um valor
async function countSec(n) {
     await new Promise(resolve => setTimeout(resolve, 1000))
     console.log(n)
}

// Conta de 1 a 5s
async function playHideSeek() {
    console.log("Vamos brincar de esconde-esconde...")
    for (let i=1; i<=5; i++) {
        // o await impede a condição de corrida
        await countSec(i)
    }
    console.log("Tô indo heim!")
}

playHideSeek()

// Requisita a URL e imprime dados JSON de uma API
let url = "https://jsonplaceholder.typicode.com/todos/1"
async function fetchData() {
    data = await fetch(url)
        .then(req => req.json())
        .catch(console.log)
    // sem o await acima, imprime-se a promessa
    console.log(data)
}

fetchData()

Ver também

Entendendo promises de uma vez por todas
Promisees: playground para visualização de promesas
await, return, return await: um comparativo

Youtube without fuss on Android

2021-04-26T00:00:00+00:00

How to watch Youtube videos without ads and interruption besides subscribing to it?

The orthodox solution is to use Youtube Vanced. It works perfectly, it’s Youtube Premium with all it’s features plus more and for free. Although it comes with a price. While I think it is fully open-source, you still have to install multiple binaries from outside the store. And in my case there was suspicious high battery usage from those apps even when they weren’t opened for days. A red flag and at least a problem for practical reasons.

The alternative that I found most straight forward was to simply use Firefox for Android coupled with uBlock Origin and Video Background Play Fix addons. Not as nice as Vanced but works without fuss.

Migrando para o Zsh e o Zinit

2021-04-22T00:00:00+00:00

O Zsh é o mais avançado e performático dos interpretadores shell e o Zinit é o mais avançado e performático dos gerenciadores de plugins para o Zsh. A seguir mostro como migrar para o Zsh e realizar uma configuração simples porém funcional utilizando o Zinit com completações, sugestões automáticas, destaque de sintaxe e o Powerlevel10k.

Por que migrar?

O Zsh é superior. Não há desvantagens em utilizá-lo, só vantagens. Você pode perder uma ou outra funcionalidade que o Fish entrega sem necessidade de configuração mas provavelmente haverá um plugin para o Zsh com essa funcionalidade e no fim do dia você vai estar em um interpretador robusto com mais recursos de linguagem, performance superior à de seus concorrentes e que possui um grande número de usuários e extensões.

Devido ao Zinit ser assíncrono, o tempo de carregamento é menor ao utilizá-lo do que ao carregar diretamente os plugins. Entretanto a principal vantagem em utilizar um gerenciador de plugins não está na rapidez mas na portabilidade. O setup do usuário passa a independer do gerenciador de pacotes do sistema e os dotfiles podem ser clonados e utilizados, a princípio, sem necessidade de modificação em qualquer outro sistema operacional que disponibilize o Zsh como shell. É até mesmo possível configurar para que o Zinit instale, caso não os encontre, programas como o fzf, que são bastante utilizados por usuários mas não omnipresentes nos sistemas.

Instruções

chsh -s $(which zsh)

Renomear o arquivo de configuração padrão, ‘.zshrc’, do Zsh

mv ~/.zshrc ~/.zshrc.old

Obs: O Zinit muda a forma como completações são carregadas e a configuração padrão do Zsh é desnecessária e indesejada.

Criar um novo ‘.zshrc’.

# Instant Prompt
# --------------
if [[ -r "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh" ]] && ! [ $ZELLIJ ]; then
    source "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh"
fi

# Zinit
# -----
declare -A ZINIT
ZINIT[BIN_DIR]="$XDG_CONFIG_HOME/zsh/zinit/bin"
ZINIT[HOME_DIR]="$XDG_CONFIG_HOME/zsh/zinit"
ZINIT[ZCOMPDUMP_PATH]="$XDG_DATA_HOME/shell/zcompdump"

if ! [ -f "$ZINIT[BIN_DIR]/zinit.zsh" ]; then # instalar se não encontrado
    git clone --depth 1 --branch master "https://github.com/zdharma/zinit" "$ZINIT[BIN_DIR]" &&
fi && source "$ZINIT[BIN_DIR]/zinit.zsh" # carregar

# Prompt
# ------
# Utilizar prompt arco-íris se em um terminal burro
if [[ "$TERM" == linux ]]; then
    autoload -U colors && colors
    export PS1="%B%{$fg[yellow]%}%n%{$fg[green]%}@%{$fg[blue]%}%M %{$fg[magenta]%}%~%{$reset_color%} $%b "

# Do contrário, utilizar o Powerlevel10k se setar um título contextual à janela
else
    zinit depth=1 for \
        load \
            romkatv/powerlevel10k \
        is-snippet \
            "$XDG_CONFIG_HOME/zsh/p10k.zsh"
	
    function x_title_precmd () {
        print -Pn -- '\e]2;%n@%m %~\a'
        [[ "$TERM" == 'screen'* ]] && print -Pn -- '\e_\005{g}%n\005{-}@\005{m}%m\005{-} \005{B}%~\005{-}\e\\'
    }
    function x_title_preexec () {
        print -Pn -- '\e]2;%n@%m %~ %# ' && print -n -- "${(q)1}\a"
        [[ "$TERM" == 'screen'* ]] && { print -Pn -- '\e_\005{g}%n\005{-}@\005{m}%m\005{-} \005{B}%~\005{-} %# ' && print -n -- "${(q)1}\e\\"; }
    }

    add-zsh-hook -Uz precmd x_title_precmd
	add-zsh-hook -Uz preexec x_title_preexec
fi

# Plugins
# -------
zinit wait lucid depth=1 for \
    atinit"zicompinit; zicdreplay" \
        zdharma/fast-syntax-highlighting \
    atload"_zsh_autosuggest_start" \
        zsh-users/zsh-autosuggestions \
    blockf atpull'zinit creinstall -q .' \
        zsh-users/zsh-completions \

# Extra
# -----
# Utilizar menu de seleção para completações
zstyle ':completion:*' menu select

Iniciar uma nova sessão

Aproveite as novas funcionalidades:

Comandos são colorizados sintaticamente;
TAB uma vez completa um comando ou expande as opções quando há mais de uma;
TAB duas vezes abre um menu para navegar entre as opções de completação;
Sugestões são recomendadas com base no histórico de comandos.

E se quiser mais ideias para customizar o seu sistema, confira este repositório com as minhas configurações.

Extensões para navegador

2021-04-20T00:00:00+00:00

Apresento algumas extensões de navegador que utilizo a fim de extender funcionalidades e melhorar minha produtividade e privacidade. A grande maioria é open-source e suporta tanto o Chromium e o Firefox.

Privacidade
Utilidade
Produtividade
Observação

Privacidade

uBlock Origin

Bloqueia anúncios, scripts maliciosos, rastreadores e outras coisas que não agregam em nada enquanto distraem o usuário e aumentam o tempo de carregamento da página. Ele também pode ser utilizado agressivamente, bloqueando scripts e fontes web para certos sites ou globalmente.

ClearURLS

Remove parâmetros de rastreio de URLs.

Exemplo:

https://www.amazon.com.br/guia-mochileiro-das-gal%C3%A1xias-ebook/dp/B00A3D9OF6/ref=sr_1_1?dchild=1&keywords=o+guia+do+mochileiro+das+gal%C3%A1xias&qid=1618948820&s=books&sr=1-1

Vira:

https://www.amazon.com.br/guia-mochileiro-das-gal%C3%A1xias-ebook/dp/B00A3D9OF6

Decentraleyes

Intercepta requisições de recursos em CDNs e os serve localmente. O que reduz o tempo de carregamento por eliminar uma requisição inútil e impede que o CDN seja utilizado para rastreio.

HTTPS Everywhere

Faz o upgrade, reescreve, requisições HTTP para HTTPS. Requisições HTTP não são encriptadas e qualquer um com a capacidade de interceptar o tráfego de rede tem acesso ao conteúdo das mensagens. No protocolo HTTPS o usuário tem as garantia da privacidade dos seus dados e da autenticidade do site.

UserAgent Switcher

Permite spoofar a identidade do navegador. Pode ser utilizada para privacidade, para limitar o fingerprinting ou mesmo para burlar alguma restrição. A exemplo: “esse site só roda no navegador X, sistema operacional Y, versão Z”.

Utilidade

Vimium

Permite navegar pela Internet utilizando apenas o teclado. Não é 100% pois, inevitavelmente, conflita com atalhos de teclado dos sites e não funciona, devido a politicas de segurança, nas URLs do tipo chrome://.*. No entanto na maior parte do tempo evita o uso do mouse e tem uma curva de aprendizado pequena para quem já está acostumado com atalhos de teclado. Agora, infelizmente, ela não implementa os recursos de edições de texto do Vim.

tecla	função
?	mostrar ajuda
o	abrir URL
O	abrir URL em nova aba
f, F	abrir link
x	fechar aba
X	reabrir aba
j, k, d, u	scroll
gg, G	início/fim
J, K	navegar entre abas
H, L	recuar e avançar

Uma solução para minimizar o último problema é utilizar a extensão New Tab Redirect. Novas abas não abrirão páginas especiais e o Vimium funcionará sem problemas. Execções podem ser adicionadas para sites em que se deseja preservar os atalhos e os binds convencionais do Chromium podem ser utilizados nesses momentos.

tecla	função
^t	abrir aba
^w	fechar aba
^[1,2…9]	ir para aba

Bypass Paywalls

Contorna automaticamente barreiras para visualização de conteúdo em centenas de sites.

Google Translate

Quebra o galho e evita ter de abrir uma nova aba quando é necessário traduzir trechos de um idioma do qual não entendo nada, como o mandarim. Basta selecionar o trecho e clicar no botão que aparece.

Highlighter

Permite marcar texto em páginas. As marcações são persistentes entre sessões.

Improved Youtube

Possibilita customizar a interface do Youtube, maximizar o tamanho do player e esconder seções como comentários e recomendados.

Markdown Here

Permite escrever texto em Markdown e convertê-lo para HTML ao pressionar CTRL + ALT + M. Suporta code fences e tudo mais. A exemplo, pode ser utilizado para enviar mensagens de e-mail em texto rico.

Dark Reader

Converte sites para o modo escuro. Possui várias opções de customização como brilho, contraste e saturação. Permite salvar configurações globais e por site, entre outros.

Produtividade

News Feed Eradicator

Oculta o feed de redes sociais como Facebook e Twitter sem impactar em demais funcionalidades. Permite configurar em quais redes ocultar.

Feeds infinitos são uma grande distração. São péssimos para se informar pois conteúdo já visto não é ocultado, na maior parte o conteúdo não é interessante e é ordenado por algoritmos bizarrros. Todavia maximizam o tempo de visualização dos anúncios e pra plataforma é isso que importa. É aquela velha estória, de que se você não tá pagando é porque você é o produto.

Eu recomendo o uso no lugar de um agregador RSS. TT-RSS e RSSHub são uma boa combinação e podem ser instalados no Docker. E para aqueles que não querem trabalho, o Feedbro é uma extensão de navegador e uma alternativa muito mais prática.

Observação

Todas as extensões apresentadas acima são de código aberto com exceção de:

Google Translate
Highlighter
AcceleReader
Feedbro

daniel @ posixtronic

JavaScript: promises, thenables, async/await

Promessas

Thenables

Async

Await

Ver também

Youtube without fuss on Android

Migrando para o Zsh e o Zinit

Por que migrar?

Instruções

Renomear o arquivo de configuração padrão, ‘.zshrc’, do Zsh

Criar um novo ‘.zshrc’.

Iniciar uma nova sessão

Extensões para navegador

Privacidade

uBlock Origin

ClearURLS

Decentraleyes

HTTPS Everywhere

UserAgent Switcher

Utilidade

Vimium

Bypass Paywalls

Google Translate

Highlighter

Improved Youtube

Markdown Here

Dark Reader

Produtividade

News Feed Eradicator

uBlacklist

Simple bookmark count

AcceleReader

Observação

daniel @ posixtronic

JavaScript: promises, thenables, async/await

Promessas

Thenables

Async

Await

Ver também

Youtube without fuss on Android

Migrando para o Zsh e o Zinit

Por que migrar?

Instruções

Setar o Zsh como interpretador shell de login.

Renomear o arquivo de configuração padrão, ‘.zshrc’, do Zsh

Criar um novo ‘.zshrc’.

Iniciar uma nova sessão

Extensões para navegador

Privacidade

Utilidade

Produtividade

Observação