javier
efc933d5d0
This PR contains the work done to extends the `Page` protocol with the head tags that control search snippets and link previews: a meta description, a canonical URL, and a social card rendered as _Open Graph_ and _Twitter_ meta tags. All three are optional with nil defaults, so existing conformers compile and render unchanged. Reviewed-on: rock-n-code/loud-amsterdam#28 Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
116 lines
3.9 KiB
Swift
116 lines
3.9 KiB
Swift
import Elementary
|
|
import Foundation
|
|
import Testing
|
|
|
|
@testable import Infrastructure
|
|
|
|
@Suite(
|
|
"Page protocol",
|
|
.tags(.`protocol`)
|
|
)
|
|
struct PageTests {
|
|
|
|
// MARK: Functional tests
|
|
|
|
@Test
|
|
func `assembles the document around the page's parts`() {
|
|
let html = StubPage().render()
|
|
|
|
#expect(html.contains("<title>Stub Page</title>"))
|
|
#expect(html.contains(#"lang="en""#))
|
|
#expect(html.contains(#"name="viewport""#))
|
|
#expect(html.contains(#"<meta name="stub" content="marker">"#))
|
|
#expect(html.contains(#"<link rel="stylesheet" href="/css/stub.css">"#))
|
|
#expect(html.contains(#"<script src="/js/stub.js"></script>"#))
|
|
#expect(html.contains("Stub content"))
|
|
}
|
|
|
|
@Test
|
|
func `places the metadata between the viewport and the stylesheets`() throws {
|
|
let html = StubPage().render()
|
|
|
|
let viewport = try #require(html.range(of: #"name="viewport""#))
|
|
let metadata = try #require(html.range(of: #"name="stub""#))
|
|
let stylesheet = try #require(html.range(of: "/css/stub.css"))
|
|
|
|
#expect(viewport.lowerBound < metadata.lowerBound)
|
|
#expect(metadata.lowerBound < stylesheet.lowerBound)
|
|
}
|
|
|
|
@Test
|
|
func `renders the scripts after the content`() throws {
|
|
let html = StubPage().render()
|
|
|
|
let content = try #require(html.range(of: "Stub content"))
|
|
let script = try #require(html.range(of: "/js/stub.js"))
|
|
|
|
#expect(content.lowerBound < script.lowerBound)
|
|
}
|
|
|
|
@Test
|
|
func `omits the summary and canonical tags by default`() {
|
|
let html = StubPage().render()
|
|
|
|
#expect(!html.contains(#"name="description""#))
|
|
#expect(!html.contains(#"rel="canonical""#))
|
|
}
|
|
|
|
@Test
|
|
func `renders the summary and canonical tags when provided`() {
|
|
let html = StubPage(
|
|
canonicalURL: "https://stub.example/",
|
|
summary: "A stub page."
|
|
).render()
|
|
|
|
#expect(html.contains(#"<meta name="description" content="A stub page.">"#))
|
|
#expect(html.contains(#"<link rel="canonical" href="https://stub.example/">"#))
|
|
}
|
|
|
|
@Test
|
|
func `omits the social card tags by default`() {
|
|
let html = StubPage().render()
|
|
|
|
#expect(!html.contains(#"property="og:"#))
|
|
#expect(!html.contains(#"name="twitter:card""#))
|
|
}
|
|
|
|
@Test
|
|
func `renders the social card tags when provided`() {
|
|
let html = StubPage(socialCard: .init(
|
|
title: "Stub Page",
|
|
summary: "A stub page.",
|
|
url: "https://stub.example/",
|
|
image: .init(
|
|
url: "https://stub.example/img/card.png",
|
|
width: 2400,
|
|
height: 1260
|
|
)
|
|
)).render()
|
|
|
|
#expect(html.contains(#"<meta property="og:type" content="website">"#))
|
|
#expect(html.contains(#"<meta property="og:title" content="Stub Page">"#))
|
|
#expect(html.contains(#"<meta property="og:description" content="A stub page.">"#))
|
|
#expect(html.contains(#"<meta property="og:url" content="https://stub.example/">"#))
|
|
#expect(html.contains(#"<meta property="og:image" content="https://stub.example/img/card.png">"#))
|
|
#expect(html.contains(#"<meta property="og:image:width" content="2400">"#))
|
|
#expect(html.contains(#"<meta property="og:image:height" content="1260">"#))
|
|
#expect(html.contains(#"<meta name="twitter:card" content="summary_large_image">"#))
|
|
}
|
|
|
|
@Test
|
|
func `appends the version token to the asset URLs`() {
|
|
let html = StubPage(assetVersion: "0123456789abcdef").render()
|
|
|
|
#expect(html.contains("/css/stub.css?v=0123456789abcdef"))
|
|
#expect(html.contains("/js/stub.js?v=0123456789abcdef"))
|
|
}
|
|
|
|
@Test
|
|
func `derives the document language from the locale`() {
|
|
let html = StubPage(locale: .init(identifier: "de-DE")).render()
|
|
|
|
#expect(html.contains(#"lang="de""#))
|
|
}
|
|
|
|
}
|