template: eticheta:1: function "upper" not defined
Șablonul (text/template sau html/template) apelează o funcție pe care nu ai înregistrat-o. Adaugă-o cu .Funcs(template.FuncMap{"upper": strings.ToUpper}) înainte de Parse; ordinea contează.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Șabloanele din Go cunosc doar câteva funcții predefinite (len, index, printf, eq, and, or, not și altele). Orice altă funcție, cum ar fi upper, lei sau formatData, trebuie înregistrată cu Funcs înainte de Parse, pentru că verificarea numelor se face la parsare. Altfel Parse întoarce template: eticheta:1: function "upper" not defined: numele șablonului, linia și funcția lipsă.
Dacă folosești template.Must(...), eroarea devine panică la pornirea programului (panic: template: ...). Asta e chiar util: greșeala apare imediat, nu la prima cerere.
Cauze tipice: ai uitat Funcs, l-ai apelat după Parse, ai scris numele altfel (Upper față de upper), sau folosești ParseFiles pe un șablon nou creat fără funcții.
De ce apare: cauzele frecvente
1Funcție neînregistrată
t := template.Must(template.New("eticheta").
Parse(`{{upper .Nume}}`))t := template.Must(template.New("eticheta").
Funcs(template.FuncMap{"upper": strings.ToUpper}).
Parse(`{{upper .Nume}}`))Funcția e cunoscută în momentul în care Parse verifică șablonul.
2Funcs apelat după Parse
t, err := template.New("t").Parse(`{{lei .Pret}}`)
t.Funcs(template.FuncMap{"lei": formatLei})t, err := template.New("t").
Funcs(template.FuncMap{"lei": formatLei}).
Parse(`{{lei .Pret}}`)La Parse funcția nu exista încă; înregistrarea ulterioară nu repară eroarea.
Repară eroarea, direct în pagină
Programul generează eticheta unui produs dintr-un șablon care afișează numele cu litere mari, prin funcția upper. Funcția nu e înregistrată, iar template.Must oprește programul cu function "upper" not defined. Înregistreaz-o înainte de Parse, ca programul să afișeze:
MOUSE - 49 leipackage main
import (
"os"
"text/template"
)
type Produs struct {
Nume string
Pret int
}
func main() {
t := template.Must(template.New("eticheta").
Parse("{{upper .Nume}} - {{.Pret}} lei\n"))
t.Execute(os.Stdout, Produs{Nume: "mouse", Pret: 49})
}MOUSE - 49 lei
Indiciu
Adaugă .Funcs(template.FuncMap{"upper": strings.ToUpper}) între New și Parse.
Reparația
package main
import (
"os"
"strings"
"text/template"
)
type Produs struct {
Nume string
Pret int
}
func main() {
t := template.Must(template.New("eticheta").
Funcs(template.FuncMap{"upper": strings.ToUpper}).
Parse("{{upper .Nume}} - {{.Pret}} lei\n"))
t.Execute(os.Stdout, Produs{Nume: "mouse", Pret: 49})
}De ce merge
Parse verifică toate funcțiile din șablon, iar upper nu era cunoscută, deci template.Must a panicat. Funcs înregistrează numele upper pentru strings.ToUpper înainte de parsare. La execuție, {{upper .Nume}} apelează funcția cu valoarea câmpului Nume, iar rezultatul MOUSE ajunge în text.
Alte forme ale mesajului
panic: template: eticheta:1: function "upper" not definedtemplate: t:1: unexpected EOFtemplate: t:1: unexpected "}" in operand
Cum o eviți pe viitor
Creează șabloanele o singură dată, la pornire, cu template.Must și cu toate funcțiile într-un FuncMap comun. Pentru pagini HTML folosește html/template (face escaping automat), cu același API. Scrie un test care parsează toate șabloanele, ca o funcție lipsă să fie prinsă în CI.
Întrebări frecvente
Ce funcții există deja în șabloane?
Printre altele: and, or, not, eq, ne, lt, gt, len, index, slice, print, printf, println, html, js, urlquery, call.
Pot apela o metodă a datelor în loc de o funcție?
Da: {{.NumeMare}} apelează metoda NumeMare() dacă tipul datelor are una exportată, fără nicio înregistrare.
Erori înrudite
template: eticheta:1:2: executing "eticheta" at <.Name>: can't evaluate field Name in type main.Produs Șablonul cere un câmp care nu există în datele primite (de obicei nume în engleză față de struct-ul în română, sau litere mici). Câmpurile folosite în șabloane trebuie să existe și să fie exportate (cu literă mare): {{.Nume}} pentru Nume string. panic: regexp: Compile(`(\d+`): error parsing regexp: missing closing ): `(\d+` Expresia regulată dată lui regexp.MustCompile are o greșeală de sintaxă (aici, o paranteză neînchisă), iar MustCompile oprește programul cu panică. Corectează modelul; pentru modele venite din exterior, folosește regexp.Compile și verifică eroarea. undefined: total Folosești un nume (variabilă, funcție, pachet) pe care compilatorul nu îl găsește în locul acela. Cauze tipice: greșeală de scriere sau de majuscule, variabila e declarată într-un bloc (if, for) și folosită în afara lui, sau ai uitat importul pachetului. Declară numele în locul potrivit sau corectează-l. Învață Go de la zero, cu exerciții la fiecare lecție
Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
