Libri
Elm
Capitolo 5. Buone pratiche di programmazione
Registrazione Eventi (Logging)

Elm:
Registrazione Eventi (Logging)

Come fare:

L’architettura di Elm non supporta effetti collaterali come il logging di base—li gestisci attraverso comandi, che sono una parte dell’architettura della tua applicazione. A scopo didattico, vediamo come potresti simulare il logging inviando messaggi a JavaScript tramite porte (ports).

Prima, definirai un modulo port:

port module Logger exposing (..)

-- Definisce una port per inviare log a JavaScript
port log : String -> Cmd msg

Nel tuo Main.elm, utilizzeresti la porta log per inviare un messaggio di log:

import Logger exposing (log)

update : Msg -> Model -> (Model, Cmd Msg)
update msg model =
    case msg of
        AnEvent ->
            -- alcuni aggiornamenti al tuo modello qui
            ( updatedModel, log "Si è verificato AnEvent." )

        AnotherEvent ->
            -- altri aggiornamenti al modello qui
            ( anotherUpdatedModel, log "Si è verificato AnotherEvent." )

Sul lato JavaScript, ti iscriveresti alla porta log per gestire i messaggi di log in arrivo:

var app = Elm.Main.init({ /* ... */ });

app.ports.log.subscribe(function(message) {
    console.log(message);
});

Un esempio di output nella console JavaScript sarebbe quindi:

Si è verificato AnEvent.
Si è verificato AnotherEvent.

Approfondimento

Tradizionalmente, in linguaggi come Python o Java, il logging viene eseguito utilizzando una libreria di logging, che fornisce un’API semplice per registrare messaggi a vari livelli quali debug, info, warning, error e critical.

Elm, con il suo focus sulla purezza e sull’immutabilità, non fornisce questo tipo di logging diretto, poiché ogni tipo di IO o effetto collaterale è gestito distintamente attraverso l’architettura di Elm.

Quando hai bisogno di un logging completo in Elm, normalmente ti affidi a strumenti JavaScript esterni. Le porte, come mostrato sopra, sono il ponte verso questi strumenti. Il modulo Debug è un’altra opzione, ma è destinato solo all’uso in fase di sviluppo e non per il logging in produzione.

In aggiunta alle porte, i programmatori spesso sfruttano i messaggi del compilatore di Elm e le facilitazioni di debugging in runtime, come Debug.log, che puoi inserire nel tuo codice per tracciare i valori. Avvolge un’espressione e registra il suo output nella console così:

view model =
    Debug.log "Debug del Modello" model
    -- il tuo codice della view qui

Tuttavia, anche questo non è destinato alla produzione. Strumenti come elm-logger forniscono alcune astrazioni sulle porte per il logging, sebbene anche questi siano destinati più allo sviluppo che alla produzione.

Vedi anche

Gestione degli erroriOrganizzazione del codice in funzioni