Książki
Elm
Rozdział 5. Dobre praktyki programowania
Rejestrowanie zdarzeń

Elm:
Rejestrowanie zdarzeń

Jak to zrobić:

Architektura Elma nie wspiera efektów ubocznych takich jak logowanie “od ręki” — obsługuje się je za pomocą komend, które są częścią architektury aplikacji. W celach edukacyjnych, sprawdźmy, jak można by symulować logowanie, wysyłając wiadomości do JavaScriptu przez porty.

Na początek zdefiniujesz moduł portu:

port module Logger exposing (..)

-- Zdefiniowanie portu do wysyłania logów do JavaScript
port log : String -> Cmd msg

W Main.elm użyjesz portu log, aby wysłać wiadomość logu:

import Logger exposing (log)

update : Msg -> Model -> (Model, Cmd Msg)
update msg model =
    case msg of
        AnEvent ->
            -- tutaj jakieś aktualizacje twojego modelu
            ( updatedModel, log "AnEvent occurred." )

        AnotherEvent ->
            -- inne aktualizacje modelu tutaj
            ( anotherUpdatedModel, log "AnotherEvent occurred." )

Po stronie JavaScripta subskrybowałbyś port log, aby obsłużyć przychodzące wiadomości logów:

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

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

Przykładowe wyjście w konsoli JavaScriptu wyglądałoby następująco:

AnEvent occurred.
AnotherEvent occurred.

Szczegółowa analiza

Tradycyjnie, w językach takich jak Python czy Java, logowanie odbywa się za pomocą biblioteki do logowania, która udostępnia proste API do logowania wiadomości na różnych poziomach, takich jak debug, info, ostrzeżenie, błąd i krytyczny.

Elm, ze swoim naciskiem na czystość i niemutowalność, nie oferuje tego typu bezpośredniego logowania, jako że wszelkiego rodzaju IO czy efekty uboczne są zarządzane w sposób wyraźny przez architekturę Elma.

Kiedy potrzeba pełnoprawnego logowania w Elm, zazwyczaj polega się na zewnętrznych narzędziach JavaScriptowych. Porty, jak pokazano powyżej, są mostem do tych narzędzi. Moduł Debug jest kolejną opcją, ale jest przeznaczony tylko do użytku deweloperskiego, a nie do logowania produkcyjnego.

Oprócz portów, programiści często korzystają z komunikatów kompilatora Elma i udogodnień do debugowania w czasie wykonania, takich jak Debug.log, które można wstawić do kodu, aby śledzić wartości. Otacza ono wyrażenie i loguje jego wynik do konsoli następująco:

view model =
    Debug.log "Model Debug" model
    -- tutaj twój kod widoku

Jednakże to również nie jest przeznaczone do produkcji. Narzędzia takie jak elm-logger dostarczają pewnych abstrakcji nad portami dla logowania, choć te również są przeznaczone bardziej do użytku deweloperskiego niż produkcyjnego.

Zobacz również

Obsługa błędówOrganizacja kodu w funkcje