Pipeline Deteksi Regex dan String Map

Satu UA string masuk ke UAParser dan keluar sebagai objek IData yang propertinya sudah terisi. Di antaranya ada satu rantai tetap: Constants, Helper, rgxMapper yang mencocokkan defaultRegexes, strMapper yang menerjemahkan hasil tangkapan, lalu createIData yang membungkus hasilnya. Halaman ini menyusuri rantai tersebut di src/main/ua-parser.js.

Aliran satu UA string

Konstruktor UAParser menetapkan userAgent dari argumen, dari header user-agent, atau dari navigator.userAgent, lalu menyiapkan httpUACH dan regexMap = defaultRegexes. src/main/ua-parser.js:1463-1470¹

Semua getter publik didaftarkan lewat setProps: getBrowser, getCPU, getDevice, getEngine, getOS, dan getResult. src/main/ua-parser.js:1493-1499² Untuk tipe selain result, fungsi pabrik dari createItemFunc membuat UAItem dengan rgxMap[itemType], memanggil parseUA(), lalu mengembalikan data. src/main/ua-parser.js:1483-1489³ getResult() membuat UAItem bertipe result dan mengisinya dari kelima getter lain. src/main/ua-parser.js:1471-1482⁴

UAItem sendiri adalah wadah: ia menyimpan itemType, ua, uaCH, rgxMap, dan data yang dibuat oleh createIData. src/main/ua-parser.js:1226-1235⁵

graph TD
    IN["UA string / headers / navigator.userAgent"] --> CTOR["UAParser: userAgent, httpUACH, regexMap"]
    CTOR --> FACT["createItemFunc"]
    FACT --> ITEM["UAItem"]
    ITEM --> PARSE["UAItem.parseUA"]
    PARSE --> MAPPER["rgxMapper"]
    MAPPER --> RGX["defaultRegexes"]
    RGX -->|"regex + props"| MAPPER
    MAPPER --> STR["strMapper / strTest"]
    MAPPER --> IDATA["IData dari createIData"]
    CH["httpUACH: UACHData"] --> PCH["UAItem.parseCH"]
    PCH --> MAPPER
    PCH --> STR
    IDATA --> RESULT["getResult()"]
    MAPPER --> NOMATCH["properti tetap undefined"]
    style RGX fill:#336791,color:#fff
    style CH fill:#336791,color:#fff
    style CTOR fill:#f59e0b,color:#000
    style FACT fill:#f59e0b,color:#000
    style MAPPER fill:#f59e0b,color:#000
    style STR fill:#8b5cf6,color:#fff
    style IDATA fill:#2d7d46,color:#fff
    style RESULT fill:#2d7d46,color:#fff
    style NOMATCH fill:#dc2626,color:#fff
%% fig: Pipeline deteksi dari UA string ke IData
%% desc: UA string mengalir melalui UAParser, UAItem, parseUA, rgxMapper, dan strMapper sebelum createIData membungkus hasilnya; parseCH memakai rgxMapper dan strMapper yang sama.

parseUA hanya bekerja untuk tipe selain result. Ia memanggil rgxMapper.call(this.data, this.ua, this.rgxMap), menambahkan major untuk browser, dan menambal versi iOS yang dibekukan Safari sejak iOS 26. src/main/ua-parser.js:1296-1318⁶

Constants dan Helper

Bagian Constants menyediakan nama properti yang menjadi kunci props (NAME, VERSION, MAJOR, TYPE, ARCHITECTURE, MODEL, VENDOR), konstanta UNKNOWN bernilai '?', dan UA_MAX_LENGTH bernilai 500. src/main/ua-parser.js:18-32⁷

Bagian Helper berisi dua belas fungsi kecil yang dipakai lintas pipeline. src/main/ua-parser.js:126-212⁸

isExtensions dipakai extend untuk memilih format masukan extension. src/main/ua-parser.js:162-166¹² has adalah inti pencocokan string map, karena ia menerima larik alias sebagai sisi pertama. src/main/ua-parser.js:153-161¹¹ enumerize menghasilkan objek yang dipasang sebagai UAParser.BROWSER, UAParser.CPU, UAParser.DEVICE, dan UAParser.ENGINE/UAParser.OS; rinciannya ada di Enums dan Konstanta Deteksi. src/main/ua-parser.js:146-152¹⁰ src/main/ua-parser.js:1516-1520²⁰

Dua helper dipakai langsung oleh metode publik parser: setUA memakai trim untuk memotong UA string ke UA_MAX_LENGTH, dan useExtension memakai extend. src/main/ua-parser.js:1501-1504²¹ src/main/ua-parser.js:1505-1508²² Pemakaian extension dibahas di Extensions: Bots, Crawlers, dan Lainnya.

Bentuk regex map

defaultRegexes menyimpan lima kunci map, dan setiap kunci berisi pasangan larik RegExp dengan larik props. src/main/ua-parser.js:347-353²³

rgxMapper membaca larik datar itu berpasangan: elemen bernomor genap adalah larik RegExp dan elemen ganjil adalah larik props, sehingga indeksnya melompat dua langkah. src/main/ua-parser.js:225-229²⁸ Perulangan berhenti pada pasangan pertama yang menghasilkan matches, jadi urutan pasangan menentukan prioritas. src/main/ua-parser.js:232-235²⁹

os adalah kunci terakhir dari defaultRegexes, dan objek map ditutup tepat sebelum bagian Factories. src/main/ua-parser.js:1079³⁰

⚠️ Urutan di dalam defaultRegexes adalah logika, bukan sekadar dokumentasi. Karena rgxMapper berhenti pada pasangan pertama yang cocok, regex yang terlalu umum sebelum regex khusus akan menutup cabang khusus itu. src/main/ua-parser.js:232-235²⁹

Menerjemahkan satu elemen props

rgxMapper mengiterasi props dengan penghitung k yang naik seiring urutan capture group, sehingga match = matches[++k] mengambil grup sesuai posisi properti. src/main/ua-parser.js:238-273³¹

graph TD
    P["props[p] = q dan match = matches[++k]"] --> T{"typeof q adalah object dan q.length > 0"}
    T -- "tidak" --> S1["this[q] = match"]
    T -- "ya" --> L{"q.length"}
    L -- "2 dan q[1] function" --> S2["this[q[0]] = q[1].call(this, match)"]
    L -- "2 dan q[1] nilai lain" --> S3["this[q[0]] = q[1], match diabaikan"]
    L -- "3 atau lebih dan q[1] function" --> S4["this[q[0]] = q[1].call(this, match, q[2])"]
    L -- "3 dan q[1] regex" --> S5["this[q[0]] = match.replace(q[1], q[2])"]
    L -- "4 dan q[1] regex" --> S6["this[q[0]] = q[3].call(this, match.replace(q[1], q[2]))"]
    P -. "match kosong" .-> U["nilai undefined"]
    style S1 fill:#2d7d46,color:#fff
    style S3 fill:#f59e0b,color:#000
    style S4 fill:#8b5cf6,color:#fff
    style S6 fill:#8b5cf6,color:#fff
    style U fill:#dc2626,color:#fff
%% fig: Cabang penanganan satu elemen props di rgxMapper
%% desc: Bentuk q menentukan apakah match dipakai langsung, diganti konstanta, atau dilewatkan ke strMapper dan fungsi sanitasi.

Setiap cabang bermuara pada satu penugasan ke this, yaitu objek data milik UAItem, karena rgxMapper selalu dipanggil dengan call. src/main/ua-parser.js:218-279³²

strMapper dan string map

strMapper mengembalikan kunci map yang cocok, mengembalikan undefined bila kunci yang cocok adalah '?', dan jatuh ke map['*'] atau ke string aslinya bila tidak ada yang cocok. src/main/ua-parser.js:285-300³³ src/main/ua-parser.js:299³⁴

windowsVersionMap dipakai di dalam props dengan bentuk [[VERSION, /(;|\))/g, '', strMapper, windowsVersionMap], [NAME, WINDOWS]], artinya hasil tangkapan dibersihkan regex lebih dulu lalu dipetakan. src/main/ua-parser.js:981-992²⁷ Bentuk pendek tanpa sanitasi juga dipakai pada cabang Windows RT. src/main/ua-parser.js:981-992²⁷

formFactorsMap dan browserHintsMap hanya dipakai jalur Client Hints. src/main/ua-parser.js:320-329³⁶ src/main/ua-parser.js:331-341³⁷

strTest adalah varian ringkas: ia mengembalikan ifTrue atau ifFalse berdasarkan satu regex saja. src/main/ua-parser.js:281-283³⁸ Contohnya [TYPE, strTest, { 'test': /ta?b/i, 'ifTrue': TABLET, 'ifFalse': MOBILE }] pada perangkat T-Mobile. src/main/ua-parser.js:790³⁹ Sebaliknya strMapper bisa langsung dipakai di props, misalnya [TYPE, strMapper, { 'mobile' : 'Mobile', 'xr' : 'VR', '*' : TABLET }]. src/main/ua-parser.js:946⁴⁰

Jalur kedua: parseCH

parseCH memakai mekanisme yang sama dengan masukan berbeda. Untuk cpu, nama arsitektur dari Client Hints ditambahi '64' bila bitness bernilai 64, lalu diumpankan ke rgxMapper sebagai archName + ';'. src/main/ua-parser.js:1353-1358⁴¹ Untuk device, model dari Client Hints di-parse ulang lewat rgxMapper.call(reParse, 'droid 9; ' + uaCH[MODEL] + ')', rgxMap) agar type dan vendor ikut terisi. src/main/ua-parser.js:1360-1388⁴² Rincian nilai Client Hints ada di Deteksi Client Hints.

Dari hasil map ke IData

defaultProps menetapkan properti awal tiap tipe: browser [NAME, VERSION, MAJOR, TYPE], cpu [ARCHITECTURE], device [TYPE, MODEL, VENDOR], engine [NAME, VERSION], os [NAME, VERSION]. src/main/ua-parser.js:1085-1111⁴³

createIData memakai daftar itu untuk membangun konstruktor IData, yang mengisi setiap properti lewat setProps dan menyimpan referensi item pemiliknya. src/main/ua-parser.js:1113-1198⁴⁴ src/main/ua-parser.js:1120-1126⁴⁵ Prototipe IData menambahkan withClientHints dan withFeatureCheck yang memanggil balik item. src/main/ua-parser.js:1128-1150⁴⁶

Bentuk objek hasil serta perilaku is, toString, dan then dibahas di API Utama dan Bentuk Hasil; withFeatureCheck dibahas di Feature Check dan Perbandingan Hasil.