WKWebView设置User-Agent的正确姿势-CSDN博客

本文链接：https://blog.csdn.net/Morris_/article/details/122923616

本文详细介绍了如何在iOS 9.0及以后版本中为WKWebView设置User-Agent，包括使用WKWebViewConfiguration的applicationNameForUserAgent属性以及在iOS 9.0之前通过evaluateJavaScript获取并设置User-Agent的方法。此外，还指出了在iOS 15中可能出现的问题以及解决方案，建议对于iOS 9.0以上版本直接使用applicationNameForUserAgent进行设置。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

如何设置WKWebView的User-Agent

iOS 9.0 和 macos 10.11, WebKit 的 WKWebViewConfiguration 这个类中新增了一个属性 applicationNameForUserAgent。

/*! @abstract The name of the application as used in the user agent string.
*/
@property (nullable, nonatomic, copy) NSString *applicationNameForUserAgent API_AVAILABLE(macos(10.11), ios(9.0));

这个注释也是写的模棱两可的，查了下文档，是这样描述的：

The user-agent is used by websites to identify the client browser.

设置 user-agent，js 以此来识别客户端浏览器。说简单点就是客户端通过设置 user-agent 的值，让 js 端能从中得知客户端浏览器是iOS，还是安卓，在iPad上还是别的网页浏览器上。

设置的一些特殊标识，一般大都是 iOS，Andriod，版本号等关键信息，通过设置这些信息，js 获取到user-agent从而判断客户端浏览器类型。

iOS 9.0 以及之后设置 user-agent 的正确姿势如下：

    WKWebViewConfiguration *config = [[WKWebViewConfiguration alloc] init];
    config.applicationNameForUserAgent = @"iOS iPad 21.00 xxx";
    self.webView = [[WKWebView alloc] initWithFrame:self.view.bounds configuration:config];
    self.webView.UIDelegate = self;
    self.webView.navigationDelegate = self;
    [self.view addSubview:self.webView];

这样设置简洁有效，设置完成之后，会在系统的user-agent后面拼上我们设置的内容，并不会取代原来的设置。

在这里插入图片描述

iOS 9.0 之前是怎么设置user-agent的呢？

- (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation {
    [webView evaluateJavaScript:@"navigator.userAgent" completionHandler:^(id _Nullable result, NSError * _Nullable error) {
        NSString *version = @"xxx";
        if (![result containsString:version]) {
            NSString *deviceIdentifier = (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad) ? @"iPad" :@"iPhone";
            webView.customUserAgent = [NSString stringWithFormat:@"%@ %@ %@ %@",result, @"iOS xxx", version, deviceIdentifier];
        }
        NSLog(@"user-Agent : %@",webView.customUserAgent);
    }];
}