ISPHttpClientConfiguration interface

SPHttpClientConfiguration 的标记接口。

扩展

属性

defaultODataVersion

自动配置“OData-Version”标头。

defaultSameOriginCredentials

自动配置 RequestInit.credentials。

requestDigest

自动提供用于身份验证的“X-RequestDigest”标头。

属性详细信息

defaultODataVersion

自动配置“OData-Version”标头。

defaultODataVersion?: ODataVersion;

属性值

注解

当指定此开关 (即未定义) 时:如果未为请求显式添加“OData-Version”标头,则 SPHttpClient 将添加标头以指定默认的 ODataVersion 指示的版本。

注意:如果没有“OData-Version”标头,则 SharePoint 服务器在大多数情况下将默认为 3.0 版本。 建议使用的版本是 4.0。

defaultSameOriginCredentials

自动配置 RequestInit.credentials。

defaultSameOriginCredentials?: boolean;

属性值

boolean

注解

当此开关为 true 时:

如果未为请求显式指定 RequestInit.credentials,则 SPHttpClient 会将它指定为“同源”。 如果没有此开关,不同的 Web 浏览器可能应用不同的默认值。

有关详细信息,请参阅规范: https://fetch.spec.whatwg.org/\#cors-protocol-and-credentials

requestDigest

自动提供用于身份验证的“X-RequestDigest”标头。

requestDigest?: boolean;

属性值

boolean

注解

当此开关为 true 时:

如果未为请求显式添加“X-RequestDigest”标头,则如果请求是写入操作,则 SPHttpClient 将添加该标头 (即“GET”、“HEAD”或“OPTIONS”) 以外的 HTTP 方法。 请求摘要由 DigestCache 服务进行管理。 在缓存缺失的情况下,可能需要执行其他网络请求。