UAParser. js - Phát hiện loại/kiểu Trình duyệt, Công cụ, Hệ điều hành, CPU và Thiết bị từ dữ liệu Tác nhân người dùng. Hỗ trợ trình duyệt và nút. môi trường js
Hiệu suất cao
Mô-đun đã được phát triển với cách tiếp cận dựa trên điểm chuẩn. Nó có một thư viện được biên dịch sẵn chứa tất cả các Biểu thức chính quy và sử dụng phân tích cú pháp hoãn lại hoặc theo yêu cầu cho thông tin về Hệ điều hành và thiết bị. Tất cả nỗ lực kỹ thuật này đều xứng đáng vì điểm chuẩn này cho thấy
Starting the benchmark, parsing 62 useragent strings per run Executed benchmark against node module: "useragent" Count [61], Cycles [5], Elapsed [5.559], Hz [1141.3739447904327] Executed benchmark against node module: "useragent_parser" Count [29], Cycles [3], Elapsed [5.448], Hz [545.6817291171243] Executed benchmark against node module: "useragent-parser" Count [16], Cycles [4], Elapsed [5.48], Hz [304.5373431830105] Executed benchmark against node module: "ua-parser" Count [54], Cycles [3], Elapsed [5.512], Hz [1018.7561434659247] Module: "useragent" is the user agent fastest parser.
Cài đặt
Quá trình cài đặt được thực hiện bằng Trình quản lý gói nút [NPM]. Nếu bạn chưa cài đặt NPM trên hệ thống của mình, bạn có thể tải xuống từ npmjs. tổ chức
npm install useragent --save
Cờ
var useragent = require['useragent'];3 yêu cầu NPM tự động thêm nó vào tệp
var useragent = require['useragent'];4 của bạn
API
Bao gồm trình phân tích cú pháp
var useragent = require['useragent'];5 trong nút của bạn. ứng dụng js
var useragent = require['useragent'];
Thư viện
var useragent = require['useragent'];5 cho phép bạn sử dụng thư viện RegEx được cài đặt tự động hoặc bạn có thể tìm nạp trực tiếp từ máy chủ từ xa. Vì vậy, nếu bạn bị hoang tưởng và luôn muốn thư viện RegExp của mình được cập nhật để phù hợp với đại lý, phạm vi rộng nhất của chuỗi
var useragent = require['useragent'];5 bạn có thể làm________số 8
Điều này sẽ tải không đồng bộ cơ sở dữ liệu từ máy chủ và biên dịch nó thành định dạng được hỗ trợ JavaScript phù hợp. Nếu nó không thể biên dịch hoặc tải nó từ vị trí từ xa, nó sẽ âm thầm quay trở lại phiên bản đã vận chuyển. Nếu bạn muốn sử dụng tính năng này, bạn cần thêm
var useragent = require['useragent'];8 và
var useragent = require['useragent'];9 vào gói của mình. json
npm install useragent --save1
đại lý người dùng. phân tích cú pháp [chuỗi người dùng [, js người dùng]];
Đây là trình phân tích cú pháp tác nhân người dùng thực tế, đây là nơi mọi điều kỳ diệu đang diễn ra. Hàm chấp nhận 2 đối số, cả hai phải là một
var useragent = require['useragent']; useragent[true];0. Đối số đầu tiên phải là chuỗi tác nhân người dùng được biết đến trên máy chủ từ tiêu đề
var useragent = require['useragent']; useragent[true];1. Đối số khác là tùy chọn và phải là chuỗi tác nhân người dùng mà bạn thấy trong trình duyệt, đối số này có thể được gửi từ trình duyệt bằng yêu cầu xhr hoặc đại loại như thế này. Điều này cho phép bạn phát hiện xem người dùng có đang duyệt web bằng tiện ích mở rộng
var useragent = require['useragent']; useragent[true];2 hay không
Trình phân tích cú pháp trả về một phiên bản Tác nhân, điều này cho phép bạn xuất thông tin tác nhân người dùng ở các định dạng được xác định trước khác nhau. Xem phần Đại lý để biết thêm thông tin
npm install useragent --save5
Phương thức phân tích cú pháp trả về một phiên bản
var useragent = require['useragent']; useragent[true];3 chứa tất cả các chi tiết về tác nhân người dùng. Xem phần Tác nhân của tài liệu API để biết các phương thức khả dụng
đại lý người dùng. tra cứu [chuỗi người dùng [, js người dùng]];
Điều này cung cấp chức năng tương tự như trên, nhưng nó lưu trữ chuỗi tác nhân người dùng và kết quả được phân tích cú pháp trong bộ nhớ để cung cấp tra cứu nhanh hơn trong tương lai. Điều này có thể hữu ích nếu bạn muốn phân tích nhiều chuỗi tác nhân người dùng
Nó sử dụng các đối số giống như phương thức
var useragent = require['useragent']; useragent[true];4 và trả về kết quả chính xác như vậy, nhưng nó chỉ được lưu vào bộ đệm
npm install useragent --save8
Và đây là một cải tiến hiệu suất nghiêm trọng như thể hiện trong điểm chuẩn này
npm install useragent --save9
đại lý người dùng. fromJSON[obj];
Chuyển đổi biểu diễn JSON của phiên bản
var useragent = require['useragent']; useragent[true];3 trở lại phiên bản
var useragent = require['useragent']; useragent[true];3 đang hoạt động
var useragent = require['useragent'];2
đại lý người dùng. là [chuỗi useragent]. tên trình duyệt;
Api này cung cấp cho bạn một tra cứu trình duyệt nhanh và bẩn. Mã cơ bản thường được tìm thấy trên các tập lệnh phía máy khách nên chất lượng không bằng phương pháp
var useragent = require['useragent']; useragent[true];4 của chúng tôi nhưng có thể cần mã này vì các lý do cũ
var useragent = require['useragent']; useragent[true];8 trả về một đối tượng có tên trình duyệt phù hợp tiềm năng
var useragent = require['useragent'];5
Đại lý, hệ điều hành và phiên bản thiết bị
Hầu hết các phương thức được đề cập ở trên đều trả về một thể hiện Tác nhân. Tác nhân hiển thị thông tin được phân tích cú pháp từ chuỗi tác nhân người dùng. Điều này cho phép chúng tôi mở rộng tác nhân với nhiều phương thức hơn mà không nhất thiết phải có trong phiên bản tác nhân cốt lõi, cho phép chúng tôi hiển thị giao diện plugin cho nhà phát triển bên thứ ba, đồng thời tạo giao diện thống nhất cho tất cả các phiên bản
Đại lý có tài sản sau
var useragent = require['useragent']; useragent[true];
9 Họ trình duyệt hoặc tên trình duyệt, mặc định là Khácnpm install useragent --save
10 Số phiên bản chính của họ, nó mặc định là 0npm install useragent --save
11 Số phiên bản phụ của họ, nó mặc định là 0npm install useragent --save
12 Số phiên bản vá lỗi của gia đình, nó mặc định là 0
Ngoài những tính chất nêu trên, nó còn có 2 tính chất đặc biệt, đó là
npm install useragent --save
13 Phiên bản hệ điều hànhnpm install useragent --save
14 Phiên bản thiết bị
Khi bạn truy cập 2 thuộc tính đó, tác nhân sẽ thực hiện phân tích cú pháp theo yêu cầu của Hệ điều hành hoặc/và thông tin Thiết bị
Hệ điều hành có các thuộc tính giống như Tác nhân, đối với Thiết bị, chúng tôi không có sẵn bất kỳ thông tin phiên bản nào, vì vậy chỉ có thuộc tính
var useragent = require['useragent']; useragent[true];9 được đặt ở đó. Nếu chúng tôi không thể tìm thấy gia đình, họ sẽ mặc định là
npm install useragent --save16
Các phương pháp sau đây có sẵn
Đại lý. toAgent[];
Trả về họ và số phiên bản được nối trong một chuỗi dễ đọc của con người
npm install useragent --save0
Đại lý. toString[];
Trả về kết quả của
npm install useragent --save17 nhưng cũng thêm hệ điều hành đã phân tích cú pháp vào chuỗi ở định dạng con người có thể đọc được
npm install useragent --save1
Đại lý. toVersion[];
Trả về phiên bản của trình duyệt trong một chuỗi có thể đọc được của con người
npm install useragent --save2
Đại lý. toJSON[];
Tạo một đại diện JSON của Tác nhân. Bằng cách sử dụng phương thức
npm install useragent --save18, chúng tôi tự động cho phép nó được xâu chuỗi khi cung cấp cho phương thức
npm install useragent --save19
npm install useragent --save3
Hệ điều hành. toString[];
Tạo ra một phiên bản chuỗi của hệ điều hành;
npm install useragent --save4
Hệ điều hành. toVersion[];
Tạo ra một phiên bản chuỗi của phiên bản hệ điều hành;
npm install useragent --save5
Hệ điều hành. toJSON[];
Tạo một biểu diễn JSON của Hệ điều hành. Bằng cách sử dụng phương thức
npm install useragent --save18, chúng tôi tự động cho phép nó được xâu chuỗi khi cung cấp cho phương thức
npm install useragent --save19
npm install useragent --save6
Thiết bị. toString[];
Tạo ra một phiên bản chuỗi của thiết bị;
npm install useragent --save7
Thiết bị. toVersion[];
Tạo phiên bản chuỗi của phiên bản thiết bị;
npm install useragent --save8
Thiết bị. toJSON[];
Tạo một đại diện JSON của Thiết bị. Bằng cách sử dụng phương thức
npm install useragent --save18, chúng tôi tự động cho phép nó được xâu chuỗi khi cung cấp cho phương thức
npm install useragent --save19
npm install useragent --save9
Thêm nhiều tính năng hơn cho useragent
Vì tôi muốn giữ cốt lõi của trình phân tích cú pháp tác nhân người dùng sạch sẽ và nhanh nhất có thể, tôi quyết định chuyển một số tính năng được lên kế hoạch ban đầu sang tệp
npm install useragent --save54 mới
Có thể tải các tiện ích mở rộng này cho nguyên mẫu Tác nhân bằng cách yêu cầu tệp
npm install useragent --save55
var useragent = require['useragent'];0
Bản phát hành đầu tiên giới thiệu 1 phương pháp mới, thỏa mãn, cho phép bạn xem liệu số phiên bản của trình duyệt có thỏa mãn một phạm vi nhất định hay không. Nó sử dụng thư viện semver để thực hiện tất cả các tính toán phạm vi nhưng đây là một bản tóm tắt nhỏ về các kiểu phạm vi được hỗ trợ