文档手册

TCefReferrerPolicy 详解

2024-05-22 22:46:40
type TCefReferrerPolicy = types.Int32

const (
   REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE = TCefReferrerPolicy(iota) // same value as REFERRER_POLICY_DEFAULT
   REFERRER_POLICY_REDUCE_REFERRER_GRANULARITY_ON_TRANSITION_CROSS_ORIGIN
   REFERRER_POLICY_ORIGIN_ONLY_ON_TRANSITION_CROSS_ORIGIN
   REFERRER_POLICY_NEVER_CLEAR_REFERRER
   REFERRER_POLICY_ORIGIN
   REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_CROSS_ORIGIN
   REFERRER_POLICY_ORIGIN_CLEAR_ON_TRANSITION_FROM_SECURE_TO_INSECURE
   REFERRER_POLICY_NO_REFERRER // REFERRER_POLICY_LAST_VALUE = REFERRER_POLICY_NO_REFERRER
)



这些常量代表了不同的 HTTP 引用策略(Referrer Policy),用于控制在 HTTP 请求中传递引用(Referer)头字段的方式。具体含义如下:

  1. REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE

    • 当从安全的 HTTPS 页面转到不安全的 HTTP 页面时,清除 Referer 头字段。这与默认策略相同。

  2. REFERRER_POLICY_REDUCE_REFERRER_GRANULARITY_ON_TRANSITION_CROSS_ORIGIN

    • 在跨域请求时,减少 Referer 头字段的详细程度。例如,只传递域名而不传递完整的 URL。

  3. REFERRER_POLICY_ORIGIN_ONLY_ON_TRANSITION_CROSS_ORIGIN

    • 在跨域请求时,只传递请求来源的域名,而不是完整的 URL。

  4. REFERRER_POLICY_NEVER_CLEAR_REFERRER

    • 从不清除 Referer 头字段,无论请求是否跨域或从安全到不安全的转换。

  5. REFERRER_POLICY_ORIGIN

    • 在所有情况下,只传递请求来源的域名,不传递完整的 URL。

  6. REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_CROSS_ORIGIN

    • 在跨域请求时,清除 Referer 头字段。

  7. REFERRER_POLICY_ORIGIN_CLEAR_ON_TRANSITION_FROM_SECURE_TO_INSECURE

    • 当从安全的 HTTPS 页面转到不安全的 HTTP 页面时,只传递请求来源的域名,而不是完整的 URL。

  8. REFERRER_POLICY_NO_REFERRER

    • 不传递 Referer 头字段,即完全不包含引用信息。

这些策略用于提高用户隐私和安全性,根据具体场景和需求选择合适的策略来控制 Referer 头字段的传递。