逆引き的な話
openapi: 3.0.0
type: string と同じ並びで以下のように記述する
minLength: 1 maxLength: 100
※もちろん両方揃っている必要はない
例えば「ニックネームは2文字以上8文字以下」としたい場合は以下のように設定する。
components:
schemas:
User:
type: object
description: "ユーザーを表すオブジェクト"
properties:
name:
description: ユーザ名
type: string
example: 鈴木太郎
nickname:
description: ニックネーム
type: string
minLength: 2
maxLength: 8
ドキュメントがわかりにくいのと、null許容はあるが、純粋nullに関しては言及がないのでそこに関してのワークアラウンド。
openapi: 3.0.0
ドキュメント曰く
Note that there is no null type; instead, the nullable attribute is used as a modifier of the base type. - Data Types | Swagger
とあり、ざっくり和訳すると
nullタイプがないことに注意してください。代わりに、nullable属性を基本的なタイプの修飾子として使用します。
ということで
nickname: description: ニックネーム、null可 type: string nullable: true
のように nullable:true を指定すると、nullであることを示すことができる。
OpenAPI3では「ここは必ずnullである」のようなものを表現する方法はない。（typeがnullが存在しない）そのため、ドキュメントとしては下記のようにnullableにして、exampleを null と記述すると、swagger editor上ではいい感じに表現されるのでコレがベターかなという形。ここらへんは仕様が変わるかもしれないので、あくまでワークアラウンド。
nullObject: description: null type: object # exampleに文字列をおく都合上 object or string nullable: true example: null
2020年1月時点で検索結果にfaviconが出るようになったのでざっくり調べた結果とか。HTML5の仕様とGoogleのガイドラインを読んでざっくりやっておいたほうがいよね的な仕様。
以前紹介してるが、HTML5から標準化されている
faviconの仕様はHTML5から標準化されている - コード日進月歩
案内が下記ページにある。
検索結果に表示されるファビコンを定義する - Search Console ヘルプ
大きく以下4つに関して言及があるのでそれぞれざっくり引用ベースで記述します。
ファビコンの絵としてどういうものでないといけないかというものが定義されている。以下まま引用。
・faviconがウェブサイトのブランドを視覚的に表したものとなっており、ユーザーが検索結果を見た際に一目でサイトを見分けられるようになっていること。 ・わいせつな表現やヘイト表現に関連するシンボル（例: かぎ十字章）などの不適切なファビコンは表示されません。該当する表現がファビコン内で見つかった場合は、デフォルトのアイコンに置き換えられます。
かなり定義が大味のドキュメントとなっている、以下の通り。
有効なファビコン設定が指しているのがWikipediaのファビコンのファイルサポートの項目なので明確に定義しているわけではない様子。なお執筆時点だと安全な選択肢は ico,png,gif。
また、表示上は16pxで表示されるので、それでも崩れないようなデザインにして欲しいという旨の注意書きがあります。
以下のfavicon記述が例示としてあげられている。
<link rel="shortcut icon" href="/path/to/favicon.ico">
rel属性でレギュレーションとして定められているのは以下の通り
shortcut iconiconapple-touch-iconapple-touch-icon-precomposedということで 標準化された仕様である icon でもOKだし、Apple向けの apple-touch-icon でもOK
パスやクローリングに関しての話。同じドメイン配下でクローリングできるようにしておいてね！！という感じに内容になっている。
Googleを考慮した場合、以下のような感じで設定するとGoogleにもよろしく、HTML5的な仕様感点からもはずれなそう。
rel = "icon" かつ ico or png で作っておけば大丈夫。思った以上にえげつない仕様が盛り込まれているので調べる
ITPのそもそもの話は過去にざっくり書いたのでそちらを参考のこと
Intelligent Tracking Prevention とはなにかざっくりまとめる - コード日進月歩
| 対象 | 起きること | この仕様になったver |
|---|---|---|
| 3rd Party Cookie | 従来方法で即時利用不可 | ITP2.1 |
| クライアント(≒JS)生成の1st Party Cookie | 特定条件に当てはまる場合に利用期間が24時間になる | ITP2.2 |
| LocalStorage | 特定条件下で即削除される | ITP2.3 |
| Referrer | パラメータがある場合にドメイン情報のみになる | ITP2.3 |
要素別に書いていく
期間を設けたり、パーティション化するなどしていたが、最終的にITP2.1にて規制が強化、ユーザにUI許可を求めるStorageAccess APIを使わないと取得できなくなった、こちらもルールがかなり煩雑かつSafariとFirefoxでしか実装されていない。
Set-Cookie でヘッダに仕込むクッキー（サーバサイドクッキーなどと呼称される）は今の所規制はないが、 document.cookie ベースのJSで作るCookie（クライアントクッキーなどと呼称される）はITP2.2にて下記の2つの条件両方に当てはまると24時間でアクセスができなくなる
HTML5から登場した、ブラウザが持つデータ領域のlocalStorage、こちらがITP2.3から規制対象となっていて、以下のような条件を満たすと削除される（らしい）。
website.example?clickID=0123456789 ）ITP2.3からトラッキング用途としてリファラが使われているというところに嘆きが入り、eLTD+1以上の情報はリファラにつかなくなる。
例としては https://sub.social.example/some/path/?clickID=0123456789 から遷移してきた場合に https://social.example としかReferrerでは取れない。
派生用語なのでまとめて
Top Level Domain の略。URLの文字列に使われるドメインにおいて、最上位レベルのドメイン文字列のことを指す。世界レベルで何があるかは決まっておりIANAが管理している。詳しくはWikipedia参考のこと。
Public Suffix と同等の意味で使われる Effecitve Top Level Domain のこと。mozillaが策定、管理している考え方で、Cookie維持の観点で従来のTLDだけでは正しく範囲を特定できないので、実質的にトップレベルドメインであるようなものをリストとして管理する、という考えがありその際に用いられる言葉。
eTLDの対象リストは以下のサイトで公開されている。
なお、CookieとTLDの考え方に関しては以下のサイト参考のこと。
「Firefox 3」のセキュリティ機能について | 日経 xTECH（クロステック）
eTLDに対して、サイトオーナーが独自に振る文字列一階層分までを示す言葉。+の数が増えるだけサブドメイン部も含まれるという意図の意味の言葉。
ドメインA を sample.example.co.jp
ドメインB を test.example.com
とした場合
| 用語 | ドメインAの場合 | ドメインBの場合 |
|---|---|---|
| TLD | jp |
com |
| eTLD | co.jp |
com |
| eTLD+1 | example.co.jp |
example.com |
あとから足すときって手順違うんだっけ？という疑問がでてやり方がよくわからなかったのでメモ、鮮度が短い情報なので2020/1時点のワークアラウンドとして捉えてもらえれば
$ firebase --version 7.11.0
initするだけ
$ firebase init functions
途中聞かれるのは以下のような質問
? What language would you like to use to write Cloud ? Do you want to use ESLint to catch probable bugs and enforce style? ? Do you want to install dependencies with npm now?
