org.cef.network

Enum CefRequest.ReferrerPolicy

java.lang.Object

java.lang.Enum<CefRequest.ReferrerPolicy>

org.cef.network.CefRequest.ReferrerPolicy

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<CefRequest.ReferrerPolicy>

Enclosing class:

CefRequest

public static enum CefRequest.ReferrerPolicy
extends java.lang.Enum<CefRequest.ReferrerPolicy>

Policy for how the Referrer HTTP header value will be sent during navigation. If the `--no-referrers` command-line flag is specified then the policy value will be ignored and the Referrer value will never be sent.

Enum Constant Summary

Enum Constants

Enum Constant and Description
REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_CROSS_ORIGIN Clear the referrer when the request's referrer is cross-origin with the request destination.
REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE Clear the referrer header if the header value is HTTPS but the request destination is HTTP.
REFERRER_POLICY_DEFAULT This is the same as REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE but here to match CEF native.
REFERRER_POLICY_LAST_VALUE Always the last value in this enumeration.
REFERRER_POLICY_NEVER_CLEAR_REFERRER Never change the referrer.
REFERRER_POLICY_NO_REFERRER Always clear the referrer regardless of the request destination.
REFERRER_POLICY_ORIGIN Strip the referrer down to the origin regardless of the redirect location.
REFERRER_POLICY_ORIGIN_CLEAR_ON_TRANSITION_FROM_SECURE_TO_INSECURE Strip the referrer down to the origin, but clear it entirely if the referrer value is HTTPS and the destination is HTTP.
REFERRER_POLICY_ORIGIN_ONLY_ON_TRANSITION_CROSS_ORIGIN Strip the referrer down to an origin when the origin of the referrer is different from the destination's origin.
REFERRER_POLICY_REDUCE_REFERRER_GRANULARITY_ON_TRANSITION_CROSS_ORIGIN A slight variant on CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE: If the request destination is HTTP, an HTTPS referrer will be cleared.

Method Summary

Modifier and Type	Method and Description
static CefRequest.ReferrerPolicy	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static CefRequest.ReferrerPolicy[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_CROSS_ORIGIN

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_CROSS_ORIGIN

Clear the referrer when the request's referrer is cross-origin with the request destination.

REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE

Clear the referrer header if the header value is HTTPS but the request destination is HTTP. This is the default behavior.

REFERRER_POLICY_DEFAULT

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_DEFAULT

This is the same as REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE but here to match CEF native.

REFERRER_POLICY_LAST_VALUE

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_LAST_VALUE

Always the last value in this enumeration.

REFERRER_POLICY_NEVER_CLEAR_REFERRER

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_NEVER_CLEAR_REFERRER

Never change the referrer.

REFERRER_POLICY_NO_REFERRER

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_NO_REFERRER

Always clear the referrer regardless of the request destination.

REFERRER_POLICY_ORIGIN

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_ORIGIN

Strip the referrer down to the origin regardless of the redirect location.

REFERRER_POLICY_ORIGIN_CLEAR_ON_TRANSITION_FROM_SECURE_TO_INSECURE

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_ORIGIN_CLEAR_ON_TRANSITION_FROM_SECURE_TO_INSECURE

Strip the referrer down to the origin, but clear it entirely if the referrer value is HTTPS and the destination is HTTP.

REFERRER_POLICY_ORIGIN_ONLY_ON_TRANSITION_CROSS_ORIGIN

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_ORIGIN_ONLY_ON_TRANSITION_CROSS_ORIGIN

Strip the referrer down to an origin when the origin of the referrer is different from the destination's origin.

REFERRER_POLICY_REDUCE_REFERRER_GRANULARITY_ON_TRANSITION_CROSS_ORIGIN

public static final CefRequest.ReferrerPolicy REFERRER_POLICY_REDUCE_REFERRER_GRANULARITY_ON_TRANSITION_CROSS_ORIGIN

A slight variant on CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE: If the request destination is HTTP, an HTTPS referrer will be cleared. If the request's destination is cross-origin with the referrer (but does not downgrade), the referrer's granularity will be stripped down to an origin rather than a full URL. Same-origin requests will send the full referrer.

Method Detail

valueOf

public static CefRequest.ReferrerPolicy valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

values

public static CefRequest.ReferrerPolicy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (CefRequest.ReferrerPolicy c : CefRequest.ReferrerPolicy.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared