Referans28 dk okuma

Hatalar

collage'ın export ettiği bütün error değerleri, nereden geldiklerine göre gruplanmış hâlde; her birinin ne anlama geldiği ve ne yapmanız gerektiğiyle birlikte.

collage hataları sentinel error değerleriyle bildirir. Bu değerler pkg/collage paketinden export edilir ve ayrıntılarla (page, path, alan) wrap edilir. Onları mesajları karşılaştırarak değil, her zaman errors.Is ile eşleştirin:

if err := app.RegisterPage(page); errors.Is(err, collage.ErrDuplicateRoute) {
	// two pages claim one path
}

Bunların çoğu uygulama açılırken bildirilir. New config'i doğrular ve bütün template'leri parse eder. Register işlemi her page'i doğrular. Uygulama başlarken de ancak kümenin tamamına bakınca görülebilecek sorunlar kontrol edilir.

Böylece sitenin bir araya getirilişindeki bir hata, onu ilk bulan okuyucuda başarısız olan bir page olarak değil, hiç başlamayan bir program olarak ortaya çıkar. collage dev altında bu ret, programın yazdıklarını gösteren bir 503 page'i olarak tarayıcıda görünür. Bkz. CLI.

Bir hata size ne zaman ulaşır. collage.New, ErrTemplateRootMissing gibi config hatalarını döner. Bir builder, ErrMissingContent gibi hatalarını kurduğu değerin üzerine kaydeder ve register bu değeri reddeder. Register, validation'ın bulduğunu döner, örneğin ErrUnknownSlot. Start ya da ListenAndServe ile başlatma, ancak kümenin tamamında görülebileni döner, örneğin ErrMountShadowsRoute. Sonrasında bir request sırasındaki hata 404, 500 ya da fallback olur, stage'iyle birlikte error hook'larına ulaşır ve production'daki error page sebebini gizler. collage.Build ile static bir build hatasını döner ya da report'a kaydeder: Errors, Skipped ve Findings. errors.Is, nasıl wrap edilmiş olursa olsun her sentinel için aynı testtir.collage.Newconfig, template'lerErrTemplateRootMissingNew dönerbuilder'larNewPage … Build()ErrMissingContentRegister'da reddedilirregisterRegister, RegisterPageErrUnknownSlotRegister dönerbaşlatmaStart, ListenAndServeErrMountShadowsRouteStart dönerbir requestcollage.Build404, 500 ya da fallbackOnError stage'i alırproduction sebebi gizlerBuild döner ya dareport'a yazar: Errors,Skipped, Findingserrors.Is(err, collage.ErrUnknownSlot)wrap edilmiş olsa da her sentinel'e aynı test
Her tür hata size farklı bir anda ulaşır. New hatalı bir config'i reddeder. Bir builder'ın kaydettiği hata, kurduğu değerin üzerinde kalır ve register bu değeri, validation'ın bulduklarıyla birlikte reddeder. Başlatma, ancak kümenin tamamında görülebileni kontrol eder: Start bu hatayı döner, Handler ise onu log'lar ve 503 ile cevap verir. Sonrasında bir request sırasındaki hata bir status'a, bir fallback'e ya da bir error page'e dönüşür ve error hook'larına ulaşır; production page'i sebep hakkında hiçbir şey söylemez. Static bir build ise hatasını döner ya da report'una kaydeder. Hangisi olursa olsun, onu errors.Is ile eşleştirin.

Aşağıdaki tablolar her hatanın nereden geldiğine göre gruplanmıştır. Mesaj, sentinel'in wrap işlemi ayrıntı eklemeden önce taşıdığı metindir. Register'ın yakaladığı üç hata ve collage'ın her biri için yazdığını nasıl okuyacağınız Örnek: register'ın yakaladığı üç hata bölümünde adım adım anlatılır.

Bazı hataların sentinel'i yoktur, çünkü bir uygulamanın onları eşleştirerek yapabileceği bir şey yoktur: New(nil), nil bir plugin ya da page, ismi boş bir plugin ya da komut, tek sayıda argüman ya da string olmayan bir key almış bir {{dict}} çağrısı, version'ı olmayan bir disk cache'i, html/template'in escape edemediği bir template (bkz. Fragment'ler ve page'ler), harf, rakam, _ ve - dışında bir şey içeren bir {{hoist}} alan ismi ve sınırı aşan bir slot resolver inline template'i (bkz. Render). Bunlar yine reddedilir; mesaj neyin yanlış olduğunu söyler.

Config

Bu hataları collage.New döner. New, uygulamayı kurmadan önce config'i kontrol eder. Bkz. Config.

HataMesajAnlamıNe yapmalı
ErrInvalidPortcollage: invalid portServer.Port, 1–65535 aralığının dışındadır.6060 için sıfır bırakın ya da geçerli bir port verin.
ErrTemplateRootMissingcollage: template root missingTemplate.Root yoktur ya da bir dizin değildir.En yaygın başlangıç hatasıdır. Çalışma dizinini kontrol edin ya da template'leri embed edin.
ErrTemplateEscapesRootcollage: template escapes rootTemplate.Root altındaki bir template, onun dışına çıkan bir yere çözülür. Bu, dizinin dışına giden bir symlink'tir.Dosyaya link vermek yerine onu dizine kopyalayın.
ErrInvalidCacheTypecollage: invalid cache typeCache.Enabled açıktır, Store yoktur ve Type ne collage.CacheMemory ("memory") ne de collage.CacheDisk ("disk")'tir.Yazımı düzeltin ya da bir Store verin.
ErrEmptyCacheDircollage: disk cache needs a directoryCache.Type"disk"'tir ve Cache.Dir boştur.Dir'i ayarlayın.
ErrLocaleDefaultNotSupportedcollage: default locale not in supported localesLocale.Supported, Locale.Default'u içermez.Varsayılan locale'i Supported'a ekleyin.
ErrNegativeDurationcollage: negative durationSekiz süre alanından biri negatiftir; mesaj hangisi olduğunu söyler.Varsayılan değer için sıfır kullanın.
ErrInvalidOrigincollage: invalid origin: want scheme://host[:port] with no path, query or fragmentBaseURL yalın bir origin değildir; bir path'i, query'si ya da fragment'i vardır, host'u yoktur (https://:8080) ya da boş bir query veya fragment işareti taşır (https://example.com/?). collage.ParseOrigin da aynı hatayı döner.Host ve port'tan sonra hiçbir şey olmadan https://example.com yazın.

Plugin'ler ve komutlar

HataMesajAnlamıNe yapmalı
ErrDuplicatePlugincollage: duplicate pluginİki plugin aynı ismi taşır.Her plugin'i bir kez register edin.
ErrConfigurerRegisteredLatecollage: plugin needs Configure and must be supplied in Config.PluginsRegisterPlugin'e Configure aşaması olan bir plugin verilmiştir, oysa bu aşama çoktan geçmiştir.Plugin'i Config.Plugins'e taşıyın.
ErrDuplicateTemplateFunccollage: duplicate plugin template functionAddTemplateFunc, daha önce eklenmiş bir isim için çağrılmıştır. İsmi başka bir plugin ya da aynı plugin ikinci kez eklemiş olabilir. json gibi built-in bir isim ya da template dilinin bir ismi (eq, len, html, urlquery…) için çağrılması da bu hatayı verir; AddTemplateFunc gibi AddRenderFunc'tan da.AddTemplateFunc bu hatayı plugin'in Configure'una döner; New ancak Configure onu dönerse başarısız olur. Plugin'ler çakışmaktadır ve Template.Funcs bunu önleyemez. Bu yüzden birini kaldırın ya da ismini değiştirin. Built-in bir ismi değiştirmesi gereken plugin'dir.
ErrUnknownPluginConfigcollage: plugin configuration names no registered pluginBir PluginConfig key'i register edilmiş hiçbir plugin'le eşleşmez. Bu, uygulama başlarken kontrol edilir.Neredeyse her zaman key'de bir yazım hatası vardır.
ErrConfigureClosedcollage: plugin configuration is closed: call it from ConfigureAddTemplateFunc ya da AddRenderFunc, plugin'in Configure'ı döndükten sonra bir ConfigHost üzerinden çağrılmıştır; hiçbir şey eklenmemiştir.Onu Configure'dan çağırın.
ErrDuplicateCommandcollage: duplicate command nameİki komut aynı ismi taşır. Ya da isim, DispatchCommands'ın kendisinin cevapladığı bir collage- ismiyse ya da bir plugin'in komutu collage binary'sinin bir ismini (build, serve…) aldıysa da.Başka bir isim seçin.
ErrInvalidCommandNamecollage: invalid command nameBir komutun ismi tek bir shell kelimesi değildir: herhangi bir yazı sisteminin harf ve rakamları, -_.:, başta bir harf ya da rakam. collage add command da böyle bir --name'i reddeder.—
ErrNilAppcollage: nil appDispatchCommands'a ya da collage.Build'e nil bir *App verilmiştir.—
ErrUnknownCommandcollage: unknown commandDispatchCommands hiç argüman almamıştır ya da hiçbir plugin'in register etmediği bir isim almıştır.Scaffold edilen main.go bu hatada bir kullanım hatası olarak 2 koduyla çıkar. Sunucu olarak çalışmayı tercih eden bir program ise bu hatada bir sonraki adıma geçebilir.
ErrStreamingBodycollage: the action's body is streamed; it is not parsed as a formBeforeActionEvent.Form(), WithStreamingBody() ile kurulmuş bir action için çağrılmış ve hiçbir şey okumamıştır.Bunu "bu action'ın kontrol edilecek form'u yok" diye yorumlayın ve request'i geçirin.

Bkz. Plugin yazmak.

Fragment'ler ve page'ler

Bu hataları iki yer bildirir. Birkaçını builder'lar zincir çalışırken kaydeder: WithSlot, WithSlotResolver ve WithSlotFragmentErrDuplicateSlot ve ErrSlotResolved'u kaydeder (WithSlotFragment ayrıca ErrNilFragment ve ErrSlotOccupied hatalarını da kaydeder). WithTimeoutErrInvalidTimeout'u, WithPathErrDuplicateLocalePath ve ErrInvalidLocale'i, WithLayoutsErrMissingLayout, ErrConflictingLayout, ErrNilFragment ve ErrFragmentCycle'ı, bir page'in Build'i ErrMissingContent'i, bir document'ın Build'i de ErrNoDocumentHandler'ı kaydeder. Bunları BuildErr() ile okuyabilirsiniz.

Bir builder'ın kaydettiği hatalar, kurduğu değerin üzerinde kalır. RegisterPage ve RegisterDocument, böyle bir hata taşıyan değeri reddeder. Hata page'in kendisine ya da ağacındaki herhangi bir fragment'e ait olabilir. Red, collage: page %q was built with errors: %w olarak wrap edilir (document için collage: document %q was built with errors: %w). Bu, BuildErr() çağrılmış olsun ya da olmasın geçerlidir.

Geri kalanları, page register edilirken validation bulur. RegisterPage ağaçtaki her fragment'i kontrol eder: isimlerini, template'lerini, slot'larını (her bağlamayı template'in çağırdığı slot'larla karşılaştırarak), verilerini, timeout'larını, TTL'lerini, path'lerini ve error page'lerini. İlk hatayı döner.

Her fragment'in kök template'i de, ilk render'ı nasıl escape edecekse öyle, bir kez escape edilir. html/template'in escape edemediği bir template (hiç kapanmayan bir <script> string'i, bir attribute'u farklı durumlarda bırakan {{if}} dalları) ilk request'te başarısız olmak yerine page'i, fragment'i ve template'i adlarıyla belirten bir hatayla reddedilir. Kendine ait bir sentinel'i yoktur; bkz. Template'ler.

WithFragmentPath ile açılan bir fragment de bu açıdan page'e dahil sayılır. Onun template'i, builder hataları ve validation'ı da diğerleri gibi register sırasında kontrol edilir. Her iki durumda da hatalı bir page, hiçbir şey serve etmeden reddedilir.

HataMesajAnlamı
ErrEmptyNamecollage: empty nameBir fragment'in ya da page'in ismi yoktur.
ErrEmptyTemplatePathcollage: empty template pathBir fragment hiçbir template belirtmez ya da NewInlineFragment'e boş bir template verilmiştir.
ErrConflictingTemplatecollage: fragment has both a template path and an inline templateElle oluşturulan bir fragment hem bir template dosyası hem de inline bir template belirtmiştir.
ErrSourceConflictcollage: inline template conflicts with another templateInline bir template kendine ait bir template'i {{define}} ya da {{block}} ile tanımlamıştır. Bu tanım, aynı isimli bir dosya template'inin yerini her page'de alırdı.
ErrNilFragmentcollage: nil fragmentFragment gereken bir yerde nil bir fragment kullanılmıştır. Bu bir slot'a bağlanmış, bir slot resolver tarafından döndürülmüş ya da WithLayouts'a verilmiş olabilir.
ErrDuplicateSlotcollage: slot already declaredWithSlot aynı isimle iki kez çağrılmıştır.
ErrUnknownSlotcollage: unknown slotBir fragment, template'inin hiç çağırmadığı bir slot'a bağlanmıştır; bağlamanın iki tarafından birinde yazım hatası vardır. Mesaj, slot'u ve template'in gerçekten çağırdığı slot'ları adlarıyla belirtir. Template'in çağırdığı ama hiçbir şeyin doldurmadığı bir slot hata değildir: boş render edilir.
ErrInvalidSlotDefinitioncollage: invalid slot definitionBir slot'un ismi boştur, map key'i slot'un kendi ismiyle eşleşmez ya da WithSlot'a SlotRequired ve SlotSingle dışında bir kural verilmiştir.
ErrSlotOccupiedcollage: slot already occupiedZaten bir fragment taşıyan bir slot'a ikinci bir fragment bağlanmıştır. Ya da bir resolver o slot için birden fazla fragment dönmüştür ya da bir page'in zincirindeki bir layout, content slot'u zaten dolu olarak gelmiştir.
ErrSlotResolvedcollage: slot is filled by a resolverAynı slot'a hem bir resolver hem de bağlanmış fragment'ler verilmiştir.
ErrRequiredSlotUnfilledcollage: required slot has no fillRequired olarak tanımlanmış bir slot'a hiçbir şey bağlanmamıştır.
ErrFragmentCyclecollage: fragment cycle detectedBir fragment'e kendisinden ulaşılabilir ya da WithLayouts aynı layout'u iki kez almıştır.
ErrMissingContentcollage: missing contentBir page'in content fragment'i yoktur.
ErrMissingLayoutcollage: missing layoutWithLayouts hiç layout verilmeden çağrılmıştır. Layout'u olmayan bir page onu çağırmaz.
ErrConflictingLayoutcollage: layout chain already declaredWithLayouts aynı builder'da iki kez çağrılmıştır.
ErrConflictingDatacollage: conflicting dataBir fragment'in verisi iki kez ayarlanmıştır: WithData veriyle iki kez çağrılmıştır ya da bir document'ta hem WithBody hem WithHandler vardır. Mesaj fragment'in adını verir: fragment "x" has its data set twice.
ErrTemplateTypecollage: template does not fit its dataBir template, fragment'inin veri tipinin veremeyeceği bir şeyi okur: örneğin böyle bir alanı olmayan bir tip üzerinde {{.Titel}}. Her bulgu, page'i, fragment'i, dosyayı, satırı ve sütunu veren bir *TemplateTypeError'dır. Bkz. Template'ler nasıl kontrol edilir.
ErrInvalidTimeoutcollage: invalid timeoutBir fragment'in ya da bir document'ın timeout'u negatiftir.
ErrInvalidTTLcollage: invalid cache ttlBir page'in ya da document'ın TTL'i negatiftir ya da Incremental'a sıfır bir TTL verilmiştir.
ErrInvalidPathcollage: invalid pathBir path pattern'i / ile başlamaz ya da bir redirect'in hedefi siteden çıkacaktır: //host, /\host.
ErrInvalidRedirectStatuscollage: invalid redirect status codeRedirect status'u 0, 301, 302, 307 ya da 308 dışında bir değerdir. Static bir build'de bir RedirectSource plugin'inin kuralı için ise bunlar ve 410 dışında bir değerdir.
ErrInvalidRedirectcollage: invalid redirectBir redirect'in From'u ya da To'su bir control karakteri içerir: \r, \n, başka herhangi biri ya da Unicode satır ve paragraf ayırıcıları. WithRedirect ya da WithPermanentRedirect döndürür; elle kurulmuş bir Redirect için de page'in Validate'i döndürür. Static bir build'de, bir RedirectSource plugin'inden gelen bozuk ya da control karakteri içeren bir kural için, From'u ya da To'su boşluk içeren bir kural için de döner; bu kuralların her biri raporlanır.
ErrSelfErrorPagecollage: page cannot reference itself as an error pageBir page kendi not-found ya da error page'idir.
ErrDuplicateLocalePathcollage: locale already has a pathWithPath, page'in, document'ın ya da action'ın zaten path'i olan bir locale'i belirtmiştir ya da bir document'ın AtRoot'u iki kez çağrılmıştır. İlk path korunur.
ErrInvalidLocalecollage: invalid localeWithPath'e boş bir locale verilmiştir. Bütün locale'lerin dışında duran bir document AtRoot(p) kullanır.

Bkz. Page'ler ve layout'lar ve Fragment'ler ve slot'lar.

Register ve routing

Bu hataları RegisterPage, RegisterNotFoundPage, RegisterErrorPage, RegisterDocument ve Register döner. Bir kısmı da uygulama başlarken ortaya çıkar.

HataMesajAnlamıNe yapmalı
ErrAppStartedcollage: application already startedUygulama başladıktan sonra bir register metodu çağrılmıştır. Başarısız olan herhangi bir başlatmadan sonra çağrılan RegisterPlugin de, RegisterCommand da buna dahildir.Handler, ListenAndServe, Start, RenderPath ya da DispatchCommands'tan önce her şeyi register edin.
ErrNilRegistrablecollage: nil passed to RegisterRegister'a page, document ya da action beklenen bir yerde nil verilmiştir; mesaj onun sırasını söyler.—
ErrDuplicatePagecollage: duplicate page nameİki page aynı ismi taşır.Link'ler page'leri isimleriyle bulur; isimleri benzersiz yapın.
ErrTemplateNotFoundcollage: template not foundBir page'in fragment'i, yüklenmemiş bir template belirtir.Path'i Template.Root'a göre, uzantısıyla birlikte kontrol edin.
ErrUnregisteredErrorPagecollage: error page not registeredBir page, hiç register edilmemiş bir not-found ya da error page belirtir. Register edilmiş olanın ikinci bir Build()'i de buna dahildir: her Build() ayrı bir page'dir. Bu, başlarken kontrol edilir.Onu RegisterNotFoundPage ya da RegisterErrorPage ile register edin ve aynı *Page'i belirtin. Register edilmemiş bir error page, gerektiğinde boş render edilirdi.
ErrInvalidPatterncollage: invalid patternBir path ya da redirect kaynağı hatalıdır: başta / yoktur, boş bir segment vardır, placeholder ismi boştur, catch-all en sonda değildir ya da etrafında metin vardır, bir segment'te iki placeholder vardır, örneğin /{name}.{ext}, ya da bir placeholder ismi iki kez kullanılmıştır, örneğin /a/{id}/b/{id}; bir link hangi id'yi doldurduğunu söyleyemez. Tek bir placeholder'ın etrafındaki metin, örneğin /feeds/{category}.xml, bir route'tur.Pattern'i düzeltin. /{name}.md ve /{name}.json'u iki ayrı route olarak kaydedin ve her placeholder'a kendi ismini verin.
ErrLocaleUnreachablecollage: no URL reaches that localeBir page, action ya da document'ın path'i ne Locale.Default olan ne de Locale.Supported'da yer alan bir locale'dedir. Ya da bir page, document, action veya redirect kaynağı, büyük-küçük harf fark etmeksizin Locale.Default'u ya da desteklenen bir locale'i adlandıran düz bir metinle başlar (/tr/guide.txt); bir request bu segment'i locale prefix'i sayıp atar. İki durumda da hiçbir istek ona ulaşamaz.Locale.Default'u yazdığınız locale yapın ya da o locale'i Supported'a ekleyin. İngilizce dışında tek dilli bir sitenin Default'u ayarlaması gerekir. Path'e prefix'i yazmayın: locale URL'ye sizin için eklenir.
ErrDuplicateRoutecollage: duplicate routeBir path ya da redirect kaynağı o locale'de zaten register edilmiştir. Bir action'ın bir page'in ya da bir document'ın path'inde GET veya HEAD'e cevap vermesi de bu hatayı verir; register sırası fark etmez.Genellikle sebep, page'inin path'iyle aynı yazılmış bir fragment path'idir. Ona kendine ait bir path verin.
ErrAmbiguousParameterNamecollage: ambiguous parameter nameİki pattern aynı pozisyonda farklı parametre isimleri kullanır, örneğin /blog/{slug} ve /blog/{id}/edit.O pozisyonda tek bir isim kullanın.
ErrOverlappingPatterncollage: overlapping patternAynı konumda etrafında metin olan iki placeholder kesişir: bir segment ikisine de uyar ama hiçbiri daha özel değildir, örneğin /a{x} ve /{x}b; /aXb ikisine de uyar. Mesaj böyle bir segment'i örnek verir.Birinin metni diğerininkiyle başlasın ya da bitsin, böylece daha özel olsun; ya da ikisine birden uyan bir segment olamayacak metinler verin.
ErrRedirectShadowsPagecollage: redirect shadows a registered pageBir redirect'in kaynağı, register sırası ne olursa olsun, bir page'in ya da bir document'ın path'iyle eşleşir. Yalnızca aynı yazılmış olanla değil: /{slug}, /about.txt'teki bir document'ı alır, /old/{rest...} de /old/keep.txt'i. Mesaj ikisini de adlarıyla verir.Redirect route'a karşı kazandığı için ikisinden birine ulaşılamazdı. Redirect'in kaynağını daraltın ya da birini kaldırın.
ErrRedirectLoopcollage: redirect loops back to its own sourceBir redirect'in hedefi, kendi kaynağının eşleştiği bir path'tir: /loop'tan /loop'a, /docs'tan /docs/'a (bir kaynak sondaki slash'li de slash'siz de eşleşir), /blog/{slug}'dan /blog/{slug}'a. Query ve fragment karşılaştırılmaz.Onu izleyen bir client hiçbir yere varamazdı: başka bir yere yönlendirin ya da kaldırın.
ErrUnsubstitutedPlaceholdercollage: redirect placeholder not captured by from patternBir redirect'in hedefi, kaynağının capture etmediği bir {name} kullanır.Onu kaynakta capture edin ya da kaldırın.

Document'lar

HataMesajAnlamı
ErrNilDocumentcollage: nil documentnil bir document register edilmiştir.
ErrEmptyContentTypecollage: empty content typeBir document hiçbir content type tanımlamaz. Content type zorunludur ve asla tahmin edilmez.
ErrNoDocumentHandlercollage: document has no handler or bodyBir document'ın ne handler'ı ne de sabit bir body'si (WithBody) vardır. Page'in aksine, geri düşebileceği bir template'i yoktur.
ErrConflictingDatabkz. Fragment'ler ve page'lerBir document'ta hem WithHandler hem WithBody vardır.
ErrDuplicateDocumentcollage: duplicate document nameİki document aynı ismi taşır.
ErrDocumentNotFoundcollage: no document at pathRenderDocumentPath path'te hiçbir document bulamamıştır. O path'te bir page ya da redirect olması da buna dahildir.
ErrEmptyDocumentBodycollage: document handler produced an empty bodyBir handler başarılı olmuş ama boş bir body dönmüştür. Serve edilirken bu bir 500'dür ve build bu document'ı yazmaz. Gerçekten "boş" demek isteyen bir handler tek bir newline dönebilir.

Bkz. Document'lar.

Mount'lar ve handler'lar

HataMesajAnlamı
ErrUnknownAssetcollage: unknown assetrc.Asset, rc.HoistStylesheet, {{asset}} ya da {{stylesheet}}'e hiçbir mount'un serve etmediği bir path verilmiştir. Mount'un serve etmeyeceği bir isim de buna dahildir: .env gibi bir dotfile ya da mount içinde geçerli bir path olmayan bir isim. 404 alacak bir link üretilmez. Bir template'te bu durumda render başarısız olur.
ErrInvalidPrefixcollage: invalid prefixBir mount prefix'i / ile başlamaz ya da bitmez, tek başına /'dır ya da // ile başlar. Ya da App.Handle'a / ile başlamayan, tek başına / olan ya da // veya bir . ya da .. segment'i içeren bir prefix verilmiştir; clean-path redirect'i bunları herhangi bir handler'a sorulmadan önce kaldırır. Mesaj hangisi olduğunu söyler. Yalnızca nokta ile başlayan bir segment sorun değildir, bu yüzden App.Handle/.well-known/'ı kabul eder. /'daki bir mount bütün route'ları yutardı.
ErrNilFScollage: nil mount file systemBir mount'a hiçbir filesystem verilmemiştir.
ErrMountConflictcollage: mount prefixes overlapİki mount ya da bir mount ile bir App.Handle prefix'i çakışan prefix'ler talep eder.
ErrMountShadowsRoutecollage: mount shadows a routeBir mount prefix'i ya da bir App.Handle prefix'i bir route'un path'ini yutardı. Bu route bir page'in, bir document'ın, bir redirect'in ya da bir action'ın olabilir. Register sırası ne olursa olsun, başlarken kontrol edilir.
ErrNilHandlercollage: nil handlerApp.Handle'a ya da App.Use'a çalıştırılacak hiçbir şey verilmemiştir.

Bkz. Static asset'ler ve Middleware ve kendi API'niz.

Render

HataMesajAnlamıNe yapmalı
ErrNotFoundcollage: not foundBu hatayı siz dönersiniz. Onu wrap eden bir data handler, içeriğin yüklenemediğini değil, var olmadığını söyler.fmt.Errorf("post %q: %w", slug, collage.ErrNotFound), required bir fragment'in hatasını 500 yerine not-found page'li bir 404'e çevirir.
ErrRequiredSlotEmptycollage: required slot is emptyRender sırasında required bir slot boştur. Bu genellikle bir resolver hiç fragment dönmediğinde olur.Fragment'in failure policy'sine tabidir.
ErrMaxDepthExceededcollage: max fragment depth exceededFragment ağacı engine'in izin verdiğinden daha derin iç içe geçer.Neredeyse her zaman sebep, doğrudan ya da dolaylı olarak kendi slot'una bağlanmış bir fragment'tir.
ErrPageNotFoundcollage: no page at pathApp.RenderPath path'te hiçbir page bulamamıştır.—
ErrCachedFetchPanickedcollage: data fetch panickedBir collage.Cached çağrısı başka bir render'ın çekme işlemini beklemiştir ve o çekme işlemi panic'e düşmüştür. Panic'in kendisi, çekme işlemi kendisine ait olan render'a gider.Key yeniden serbesttir: bir sonraki render veriyi çeker. Panic'e neden olan şeyi düzeltin.
ErrCSRFDisabledcollage: csrfToken used but request-forgery protection is disabledSecurity.DisableCSRF ayarlanmış bir uygulamada bir template {{csrfToken}} çağırır.Çağrıyı kaldırın ya da korumayı yeniden açın.

Bir collage.Key ismi ve tipinden oluşur. Bu yüzden iki farklı tiple istenen tek bir isim, iki ayrı değer tutan iki key'dir; bir hata değildir.

Bilinmesi gereken üç render hatası:

  • Sınırı aşan slot resolver inline template'leri. Engine, program çalıştığı sürece slot resolver'ların fragment'lerinin getirdiği en fazla 256 farklı inline template'i kabul eder; sonraki, fragment'ini errors.Is'in tanıdığı collage.ErrTooManyInlineSources ile başarısız kılar. Inline bir template bir sabittir, asla veriden kurulmaz. Bkz. Inline template'ler.
  • Harf, rakam, _ ve - dışında bir şey içeren bir {{hoist}} alan ismi render'ı başarısız kılar: collage: hoist area "…": a name is letters, digits, '_' and '-'.
  • Panic'e düşen bir collage.Once çekme işlemi. Key'i bekleyen her fragment collage: Once "…": the fetch panicked: … ile hemen serbest bırakılır; panic'in kendisi, çekme işlemi kendisine ait olan fragment'e gider.

Cache'lenen bir page için page cache'te bulamayan eşzamanlı request'ler tek bir render'ı paylaşır. O render panic'e düşerse, onu bekleyen request'ler de 500 ile cevaplanır ve bir sonraki request yeniden render eder.

Bir data handler'daki, bir slot resolver'daki ya da bir template fonksiyonundaki panic process'i çökertmez. Panic bir collage.PanicError'a dönüşür ve fragment diğer her hatada olduğu gibi başarısız olur. Panic değerine ve stack'ine ulaşmak için ona errors.As ile erişin:

var panicked *collage.PanicError
if errors.As(err, &panicked) {
	log.Printf("panic: %v", panicked.Value)
}

Bir hatanın nasıl 404'e, 500'e, fallback'e ya da hiçbir şeye dönüştüğünü görmek için Data handler'lar sayfasına bakın.

Development'ta built-in 500 page'i hatanın sebebiyle başlar. Template kaynaklı bir hatada, başarısız olan çağrının template'ini, satırını, sütununu ve ne döndüğünü gösterir. Hatanın yukarı çıkarken geçtiği template zinciri bunun altında yer alır. Production page'i değişmemiştir ve sebep hakkında hiçbir şey söylemez.

Bu hataları App.URL, App.ActionURL ve App.FragmentURL döner. {{pageURL}}, {{actionURL}}, {{pageURLIn}}, {{localeURL}}, {{fragmentURL}} ve {{fragmentURLIn}} ise başarısız olan render'larla bildirir. Bkz. Link'ler ve locale'ler.

HataMesajAnlamı
ErrUnknownRoutecollage: no page or document by that nameO isimle register edilmiş hiçbir page ya da document yoktur. Ya da ikisi birden vardır ve link belirsizdir.
ErrNoPathInLocalecollage: no path in that localeRoute'un istenen locale'de bir path'i yoktur. {{pageURL}} bu durumda varsayılan locale'e fallback yapar, {{localeURL}} ise boş string render eder.
ErrRouteParamscollage: route parameters do not match the patternBir parametre eksik ya da boştur, hiçbir placeholder'a karşılık gelmez, . ya da ..'dır, string, tam sayı ya da fmt.Stringer değildir ya da template tek sayıda argüman vermiştir.
ErrLocaleUnreachablecollage: no URL reaches that localeLocale ne Locale.Default'tur ne de Locale.Supported'da yer alır. Böyle bir locale'de path register etmek de bu hatayı verir; bkz. Register ve routing.
ErrUnknownFragmentPathcollage: the page opened no fragment path by that namePage, WithFragmentPath ile o adda bir fragment açmamıştır. Adıyla istenen RenderFragment, hiçbir request'in taşıyamayacağı parametreler, fragment'in path'i olmayan bir locale ya da temiz yazımında olmayan bir path için de onu döner.
ErrAmbiguousFragmentPathcollage: the fragment is opened at more than one pathPage fragment'i o locale'de iki path'te açmıştır, bu yüzden link birini seçemez.

Action'lar

Bu hataları RegisterAction döner. RegisterPage de bir page'e eklenmiş action'ı kontrol eder: ErrNilAction, ErrNoActionMethods, ErrNoActionHandler ve ErrDuplicateAction. nil bir fragment path'ini ise ErrNilFragmentPath ile reddeder.

Tek bir ErrNoActionHandler vardır; register sırasında ve request'te aynı değerdir. Kurulurken hata kaydetmiş bir action (örneğin WithPath'te tekrar eden bir locale) da register sırasında reddedilir; ActionBuilder.BuildErr() bu hataları önceden okur.

HataMesajAnlamıNe yapmalı
ErrNilActioncollage: nil actionnil bir action register edilmiş ya da bir page'e eklenmiştir.—
ErrEmptyActionNamecollage: action has no nameBir action'ın ismi yoktur.Ona bir isim verin; log'larda ve hatalarda action'ı bu isim tanımlar.
ErrDuplicateActioncollage: duplicate actionAlınmış bir isimle ikinci bir action register edilmiştir.—
ErrNoActionPathscollage: action has no pathsBağımsız bir action'ın WithPath'i yoktur.Bir page'e bağlı action page'in path'lerini alır; tek başına duran bir action'ın kendi path'leri olmalıdır.
ErrNoActionHandlercollage: action has no handlerBir action'ın WithHandler'ı yoktur.—
ErrInvalidActionMethodcollage: action method is reserved for the serverBir action, sunucunun kendisinin cevapladığı OPTIONS, TRACE ya da CONNECT'i bildirir. Mesaj action'ın ve method'un adını verir.Onu WithMethods'tan çıkarın. CORS preflight'ı bir middleware'e aittir.
ErrStreamingBodyMethodcollage: a streaming body needs POST, PUT or PATCHWithStreamingBody() ile kurulmuş bir action POST, PUT ya da PATCH'ten hiçbirine cevap vermez. Mesaj action'ı ve method'larını belirtir.Bunlardan birini ekleyin ya da WithStreamingBody()'yi kaldırın.
ErrNegativeBodyTimeoutcollage: an action's body timeout must not be negativeWithBodyTimeout'a negatif bir süre verilmiştir.Sıfır, sunucunun deadline'larını korur.
ErrNoActionMethodscollage: action declares no methodsBir action hiçbir method'a cevap vermez.WithMethods(http.MethodPost) kullanın ya da page'de WithAction kullanın.
ErrNilFragmentPathcollage: fragment path has no fragmentWithFragmentPath'e nil bir fragment verilmiştir.—
ErrUnregisteredPagecollage: action answered with a page that was never registeredBir action'ın RenderPage'i register edilmemiş bir page dönmüştür. Register edilmiş bir page'in ikinci bir Build()'i de buna dahildir; o başka bir page'dir. Request 500 ile başarısız olur.Page'i register edin ve handler içinde yeni bir page kurmak yerine aynı değerle cevap verin.
ErrAmbiguousActionResultcollage: action result sets more than one of Location, Fragment, Page, BodyBir action'ın ActionResult'ı Location, Fragment, Page ve Body'den ikisini ya da daha fazlasını ayarlamıştır; mesaj alanları adlarıyla verir. Request 500 ile başarısız olur ve error hook'ları onu "render" stage'i altında alır.Bunlardan yalnızca biriyle cevap verin. Yalnızca Status ya da Header taşıyan bir sonuç sorunsuzdur.

Bkz. Form'lar ve action'lar.

Vary ve SkipCache

Bu hataları collage.Vary ve collage.SkipCache döner. Bu iki fonksiyon middleware içinden çağrılmalıdır. Bkz. Caching ve Preview'lar.

HataMesajAnlamıNe yapmalı
ErrVaryTooLatecollage: Vary or SkipCache called after routing; call it from middlewareVary ya da SkipCache routing başladıktan sonra çağrılmıştır, örneğin bir data handler'dan. Her route'ta reddedilir.Onu App.Use ile register edilmiş bir middleware'den çağırın.
ErrVaryOutsideRequestcollage: Vary or SkipCache called on a request collage is not servingVary ya da SkipCache, collage'ın handler'ından geçmemiş bir request üzerinde çağrılmıştır.—

Request forgery

Forgery kontrolünden geçemeyen bir gönderim, action'ın handler'ı çalışmadan önce 403 ile cevaplanır. Error hook'ları sebebi "route" stage'i altında, action'ın ismiyle wrap edilmiş olarak alır:

HataMesajAnlamı
ErrCSRFMissingcollage: no csrf tokenGönderimde token ya da cookie yoktur.
ErrCSRFMismatchcollage: csrf token does not matchToken, cookie'deki token değildir.
ErrCSRFInvalidcollage: csrf token is not validToken bu uygulamanın key'iyle imzalanmamıştır.
ErrCSRFCrossOrigincollage: cross-origin requestTarayıcı, gönderimi Sec-Fetch-Site ile ya da Host olmayan bir Origin ile başka bir origin'den gönderilmiş olarak işaretlemiştir. Gönderim, taşıdığı token ne olursa olsun reddedilir.
ErrCSRFHeaderRequiredcollage: no csrf token from the headerWithStreamingBody() ile kurulmuş bir action'a yapılan gönderim, böyle bir action'ın baktığı tek yer olan X-CSRF-Token'da (ya da Security.CSRFHeaderName'de) token taşımamıştır. ErrCSRFMissing'i wrap eder, bu yüzden errors.Is ikisiyle de eşleşir.

Yaygın sebepler iki tanedir: {{csrfToken}} içermeyen bir form ve her process'te yeniden üretilen bir key. Token'ların restart'lardan sonra da geçerli kalması ve instance'lar arasında çalışması için Security.CSRFKey'i ayarlayın. Streaming bir action'a post eden düz bir HTML form'u ErrCSRFHeaderRequired ile reddedilir. Form header ayarlayamaz, bu yüzden onu fetch() ile gönderin. Boyut limitini aşan bir body ise 413 ile cevaplanır; limite takılan şey token'ın okunması olsa bile böyledir. net/http'nin okuduğu en büyük boyut olan 10 MB'ı aşan urlencoded bir form da, MaxBodyBytes ne kadar yüksek olursa olsun, 413 ile cevaplanır. Bkz. Form'lar ve action'lar.

Form'u, üretilemeyen bir token'a ihtiyaç duyan bir page (sistemin rastgele kaynağı başarısız olmuştur), her gönderimi reddedilecek bir form'la sunulmak yerine 500 ile cevaplanır.

Security.DisableCSRF ayarlanmış bir uygulamada {{csrfToken}} kullanmak ErrCSRFDisabled hatasına yol açar; bkz. Render.

Error hook'larına bildirilenler

Bu hatalar bir plugin'in OnError'una ErrorEvent.Err içinde ulaşır. Böylece plugin, mesajları okumadan hataları birbirinden ayırabilir. Bkz. Plugin yazmak.

HataMesajStageAnlamı
ErrNoRoutecollage: no route matched the requestnot_foundHiçbir route request'le eşleşmemiştir; bu bir link ya da routing sorunudur. Bilerek ErrNotFound değildir: ikisi de 404'tür, ama sebepleri farklıdır.
ErrNotFoundbkz. RenderrenderRequired bir fragment'in içeriği yoktur; bu bir içerik sorunudur.
ErrMethodNotAllowedcollage: method not allowedroutePath vardır ama o method'a cevap vermez. Sonuç, cevap verdiği method'ları listeleyen bir Allow header'ıyla birlikte 405'tir. Bir document'ın URL'sinde bu 405 düz metindir.
ErrEmptyRendercollage: page rendered no markuprenderBir page başarıyla render edilmiş ama hiç markup üretmemiştir. Page ister serve edilsin ister bir action'ın cevabı olsun, sonuç 500'dür. Static build'in kaydettiği sentinel de budur.
ErrAmbiguousActionResultbkz. Action'larrenderBir action iki cevap isteyen bir sonuçla cevap vermiştir.
ErrCSRFMissing, ErrCSRFMismatch, ErrCSRFInvalid, ErrCSRFCrossOrigin, ErrCSRFHeaderRequiredbkz. yukarıdarouteForgery kontrolünün reddettiği bir gönderim.
ErrInvalidGuardDecisioncollage: invalid guard decisionguardBir page'in guard'ı yazılamayacak bir kararla cevap vermiştir (location'ı olmayan bir redirect, bir 200) ve request 500 ile başarısız olmuştur. Hata dönen bir guard da aynı stage'de, kendi hatasıyla bildirilir.
ErrGuardRefusedcollage: the guard refused this reader—Bildirilmez, döndürülür: RenderFragment, guard'ı okuyucuyu reddeden bir fragment istemiştir ya da bir middleware request'i iletmek yerine ona cevap vermiştir: bir 401, bir 429, bir redirect. Fragment stream eden bir plugin o okuyucuya hiçbir şey göndermez.
ErrEmptyErrorPagecollage: error page rendered emptyerror_pageRegister edilmiş bir error page başarıyla render edilmiş ama hiç markup üretmemiştir. Bu yüzden onun yerine built-in page serve edilmiştir.
ErrPaniccollage: panic recovered while serving the requestpanicServe sırasında bir şey panic etmiş ve bu panic recover edilip 500'e çevrilmiştir. Bu bir Cache, Metrics ya da Tracer implementasyonu, bir router veya bir plugin hook'u olabilir. Data handler'lardaki ve template'lerdeki panic'ler ise PanicError olur.
ErrAssetFailedcollage: asset request failedassetMount edilmiş bir dosya request'i 400 ya da üstü bir status ile cevaplanmıştır. Bu tür bütün status'lar için tek bir sentinel vardır.
ErrHandlerFailedcollage: mounted handler failedhandlerApp.Handle ile mount edilmiş bir handler server error ile cevap vermiştir.
ErrUnsafeRedirectTargetcollage: unsafe redirect targetrouteBir redirect'in hedefi, substitution'dan sonra tek slash'le başlayan relative bir path değildir: //host, /\host ya da control character içeren bir path'tir. Bir Location header'ıyla değil, 500 ile cevaplanır. Böyle yazılmış bir hedef register sırasında ErrInvalidPath ile reddedilir. Yakalanan bir değer ise böyle bir hedef oluşturamaması için escape edilir.

Body limitinin ötesini okuyup ardından başarısız olan bir action'ın handler'ı hangi hatayı döndürürse döndürsün 413 olarak bildirilir. Hook handler'ın kendi hatasını alır ve errors.As onun üzerinde bir *http.MaxBytesError bulur. Body'si yarıda kesilen bir action (client gitmiş ya da okuma deadline'ı geçmiştir) 400 ya da 408 ile cevaplanır ve hiçbir error hook'una ulaşmaz; debug seviyesinde log'lanır. Bkz. Streaming body'ler.

Alarm kurmaya değer stage "error_page"'dir (collage.StageErrorPage; her stage'in bir Stage* sabiti vardır). Hataları bildiren page'in kendisi başarısız olmuştur, ama okuyucu yine de makul görünen bir page görmüştür. Bu yüzden size bunu başka hiçbir şey söylemez.

Static build'ler

Bu hataları collage.Build döner ya da döndüğü BuildReport'a kaydedilirler. Bkz. Static export.

HataMesajNeredeAnlamı
ErrNilAppbkz. Plugin'ler ve komutlarBuildApp nil'dir.
ErrEmptyOutDircollage: empty output directoryBuildBuildOptions.OutDir boştur.
ErrDangerousOutDircollage: refusing to use a dangerous output directoryBuildOutDir, symlink'ler izlendikten sonra bir filesystem root'una çözülür. Clean açıksa, projenin kendisini içerdiğinde de bu hatayı verir: bir repository root'u, çalışma dizini ya da module root'u veya bunların üstündeki herhangi bir dizin (-out ..). Boş olmayan ve .collage-export işaretini taşımayan bir dizin de reddedilir: Clean yalnızca bir build'in oluşturduğu ya da boş bulduğu bir dizini boşaltır. Bu, hiçbir şey silinmeden ya da yazılmadan önce kontrol edilir. İşareti olmayan bir output dizinini Clean'in boşaltabilmesi için işareti bir kez oluşturun: touch dist/.collage-export.
ErrOutputPathCollisioncollage: two builds target one output pathBuildİki page, iki document ya da bir page ile bir document aynı dosyaya yazılacaktır. Sebep yalnızca sondaki slash'le ya da yalnızca büyük-küçük harfle ayrılan pattern'ler (/Go ile /go macOS'ta ve Windows'ta tek bir dosyadır ve her platformda çakışır), aynı değerleri iki kez listeleyen bir WithStaticParams ya da bir page'in index.html'ine düşen bir document olabilir. Build OutDir'e dokunmadan durur: hiçbir şey temizlenmez ya da yazılmaz ve BuildFinishedHook çağrılmaz.
ErrPathEscapesOutDircollage: resolved path escapes the output directoryreport errorBir output path'i ya da ona giden yoldaki bir symlink OutDir'in dışına çıkar. Bu, o dosya yazılmadan önce kontrol edilir; yalnızca o path başarısız olur.
ErrDynamicPathUnresolvedcollage: a path pattern with a {param} needs WithStaticParams to be builtskipBir page'in ya da document'ın path'inde bir {param} vardır ve WithStaticParams yoktur.
ErrRouteParamsbkz. Link'ler ve URL'lerreport errorWithStaticParams'ın döndüğü bir map pattern'i tam olarak doldurmaz: bir isim eksiktir ya da pattern'de olmayan bir isim vardır; ya da bir değer ters bölü veya NUL içerir (Windows'ta ters bölü bir ayırıcıdır). Yalnızca o dosya başarısız olur, geri kalanlar build edilir.
ErrNotStaticcollage: a Dynamic() route cannot be built staticallyskipBir page ya da document dynamic'tir: ya Dynamic() olarak tanımlanmıştır ya da strateji tanımlamayıp data handler'ı olan bir şey render eder. Dolayısıyla export edilecek bir şey yoktur.
ErrGuardedcollage: a guarded page cannot be built staticallyskipBir page'in layout zincirinde ya da content fragment'inde bir guard vardır. Export'ta guard'a sorulacak bir okuyucu yoktur, static host'taki bir dosya ise herkese sunulur.
ErrDuplicateRedirectcollage: two redirects from one pathreport errorRouter'ın tek bir redirect saydığı iki redirect vardır: /old ile /old/ ya da /blog/{slug} ile /blog/{x}. Page'lerden, document'lardan ya da bir RedirectSource plugin'inden gelebilirler. Static bir host hangisinin geçerli olacağını kendi önceliğiyle seçerdi.
ErrRedirectShadowsFilecollage: a redirect shadows a written filereport errorBir redirect, build'in yazdığı bir dosyanın path'iyle eşleşir: about/index.html yanındaki /about ya da /about/, docs/x/index.html yanındaki /docs/{rest...}. Pattern'i daraltın ya da page'i kaldırın.
ErrDegradedRendercollage: refusing to write a degraded renderreport errorBir page başarısız olan bir fragment'le render edilmiştir ve AllowDegraded kapalıdır. Hiçbir dosya yazılmaz.
ErrEmptyRendercollage: page rendered no markupreport errorBir page hiç markup render etmemiştir. AllowDegraded açık olsa bile reddedilir. Yukarıda serve için anlatılanla aynı sentinel'dir.
ErrUnresolvedTokencollage: refusing to write a page whose forgery token was never resolvedreport error, skipNot-found page bir {{csrfToken}} taşıyorsa bu bir report error'dır. Token taşıyan diğer page'ler ise atlanır, çünkü onlar bir sunucuya ihtiyaç duyar.
ErrBuildPaniccollage: panic while building a pagereport errorBir page'in render edilmesi ya da yazılması ya da bir WithStaticParams fonksiyonu panic etmiştir. İkincisi o route'un o locale'ini başarısız kılar. Build bunu recover etmiş ve diğerleriyle devam etmiştir.
ErrEmptyDocumentBodybkz. Document'larreport errorBir document boş bir body üretmiştir.
ErrBuildFindingscollage: checks reported errorsreport errorBir plugin BuildFinishedHook'tan error seviyesinde bir finding bildirmiştir. Page'ler yazılmıştır; bulunanlar BuildReport.Findings'tedir.

Report error'lar BuildReport.Errors içindedir. Bu, errors.Is ile eşleşen hatalardan oluşan bir slice'tır. Bir atlama ise BuildReport.Skipped içindeki bir SkipRecord'dur. Onun Reason'ı insanlar için yazılmış bir cümledir. Err'i ise kod için sentinel'dir: ErrNotStatic, ErrGuarded, ErrDynamicPathUnresolved ya da ErrUnresolvedToken. Bu yüzden Reason'ı okumak yerine onu errors.Is(skip.Err, …) ile eşleştirin.

Örnek: register'ın yakaladığı üç hata

Yeni bir proje page'lerini routes.go'da register eder. Scaffold edilen main.go ilk hatada durur ve onu saatin ve projenin isminin ardından yazar (aşağıda saat gösterilmez). Buradaki projenin ismi blog'dur. Register reddettiği ilk öğede durur, bu yüzden bu hatalar her çalıştırmada birer birer gelir: düzeltin, yeniden çalıştırın, sıradakini okuyun.

Her satır dıştan içe okunur:

  • blog: önekini main.go ekler;
  • register page "home":, Register'ın reddettiği öğeyi adıyla belirtmesidir;
  • collage: unknown slot, sentinel'in yukarıdaki tablolarda da yer alan mesajıdır;
  • geri kalanı ayrıntıdır: page, fragment, template.

Yazım hatalı bir slot ismi

Home page'in content'i bir aside'ı bir slot'a bağlar, ama slot'un ismini template'ten farklı yazar:

func Home() *collage.Fragment {
	return collage.NewFragment("home", "pages/home.html").
		WithSlotFragment("sidebr", Aside()).
		Build()
}
<h1>Home</h1>
{{slot "sidebar"}}
blog: register page "home": collage: unknown slot: page "home" fragment "home" binds into slot "sidebr", but template "pages/home.html" never calls it; it calls [sidebar]

Cevap satırın sonundadır: template sidebar'ı çağırır, Go tarafı ise sidebr'a bağlar. Hangi taraf yanlışsa onu düzeltin. Bu kontrol olmasaydı aside her request'te hiçbir yerde render edilmezdi.

Bir slot'un ismini render sırasında hesaplayan bir template herhangi bir slot'u çağırabilir, bu yüzden onun bağlamaları bu şekilde kontrol edilmez.

Verinin sahip olmadığı bir alan

Post'un fragments/pages/post.go'daki (package fragments) content'i template'ine bir postView verir, template ise bir alanın ismini yanlış yazar:

type postView struct {
	Title string
}

func Post() *collage.Fragment {
	return collage.NewFragment("post", "pages/post.html").
		WithData(collage.Value(postView{Title: "Hello"})).
		Build()
}
<h1>{{.Titel}}</h1>
blog: register page "post": collage: page "post": fragment "post" (pages/post.html:1:6): {{.Titel}}: type fragments.postView has no field or method Titel (did you mean Title?)

Bu hata, sentinel'inin mesajını (collage: template does not fit its data) taşımaz. Her bulgu bir *collage.TemplateTypeError'dır ve kendini şöyle yazar: page, fragment, template'in dosyası, satırı ve sütunu, ifade, ifadedeki sorun ve yakın bir isim varsa muhtemelen kastettiğiniz isim. {{.Title}} yazın.

errors.Is(err, collage.ErrTemplateType) yine de onunla eşleşir. Page'de daha önce reddedilen başka bir şey yoksa, page'in template'lerindeki bütün bulgular tek seferde, her biri ayrı bir satırda bildirilir. Eksik bir template ya da yanlış bir slot bağlaması, kontrolü bulgular döndürülmeden önce durdurur. errors.As ilk bulgunun alanlarına ulaşır:

var typeErr *collage.TemplateTypeError
if errors.As(err, &typeErr) {
	fmt.Printf("%s:%d:%d: %s\n", typeErr.Template, typeErr.Line, typeErr.Col, typeErr.Expr)
}

Page'inin path'indeki bir fragment path'i

Search page'i, bir script sonuçları yenileyebilsin diye onları ayrı bir URL'de açar, ama onlara page'in kendi path'ini verir:

func Search() *collage.Page {
	return collage.NewPage("search").
		WithLayouts(layouts.Master()).
		WithContent(fragments.Search()).
		WithPath("en", "/search").
		WithFragmentPath("en", "/search", fragments.SearchResults()).
		Build()
}
blog: register page "search": collage: duplicate route: action "search:search-results" and page "search" both answer GET "/search" for locale "en"

Mesajdaki action sizin yazdığınız bir action değildir. collage bir fragment path'ini, GET'e cevap veren ve page ile fragment'in isimlerini taşıyan bir action ile serve eder; fragments.SearchResults()search-results isimli fragment'i kurar. Bu action'ın path'i page'in kendi path'idir, bu yüzden GET /search'e iki route cevap verir. Fragment'e kendine ait bir path verin, örneğin /search/results.

Aynı path'teki iki page de durumu aynı biçimde bir mesajla bildirir: page "team" and page "about" both claim "/about" for locale "en".

Bir test ile yakalayın

Üç hatayı da register döner, dolayısıyla newApp da onları döner. Onu çağıran bir test, hiçbir şey deploy edilmeden aynı hatayla başarısız olur. Start buna, uygulama başlarken kontrol edilenleri ekler:

func TestAppStarts(t *testing.T) {
	app, err := newApp(collage.Env{CacheDir: t.TempDir()})
	if err != nil {
		t.Fatalf("newApp() = %v, want nil", err)
	}
	t.Cleanup(func() { _ = app.Shutdown(context.Background()) })
	if err := app.Start(); err != nil {
		t.Fatalf("start: %v", err)
	}
}

Bkz. Test yazmak.