React'ning useDeferredValue hook'i: Bloklanmaydigan UI unumdorligi bo'yicha mukammal qo'llanma

Zamonaviy veb-dasturlash dunyosida foydalanuvchi tajribasi birinchi darajali ahamiyatga ega. Tez va sezgir interfeys endi hashamat emas, balki kutilayotgan narsadir. Butun dunyo bo'ylab, turli xil qurilmalar va tarmoq sharoitlaridagi foydalanuvchilar uchun sekin ishlaydigan, qotib qoladigan UI qaytib keluvchi mijoz va yo'qotilgan mijoz o'rtasidagi farq bo'lishi mumkin. Aynan shu yerda React 18 ning konkurent xususiyatlari, xususan, useDeferredValue hook'i o'yin qoidalarini o'zgartiradi.

Agar siz katta ro'yxatni filtrlaydigan qidiruv maydoni, real vaqt rejimida yangilanadigan ma'lumotlar jadvali yoki murakkab boshqaruv paneli bilan React ilovasini yaratgan bo'lsangiz, ehtimol qo'rqinchli UI muzlashiga duch kelgansiz. Foydalanuvchi yozadi va bir lahzaga butun ilova javob bermay qoladi. Bu an'anaviy renderlash React'da bloklovchi bo'lgani uchun sodir bo'ladi. Holat yangilanishi qayta renderlashni ishga tushiradi va u tugamaguncha boshqa hech narsa sodir bo'lmaydi.

Ushbu keng qamrovli qo'llanma sizni useDeferredValue hook'ini chuqur o'rganishga olib boradi. Biz u hal qiladigan muammoni, React'ning yangi konkurent mexanizmi bilan qanday ishlashini va undan qanday qilib ko'p ish qilayotganda ham tez his etiladigan ajoyib darajada sezgir ilovalar yaratish uchun foydalanishingiz mumkinligini o'rganamiz. Biz amaliy misollar, ilg'or patternlar va global auditoriya uchun muhim bo'lgan eng yaxshi amaliyotlarni qamrab olamiz.

Asosiy muammoni tushunish: Bloklovchi UI

Yechimni qadrlashdan oldin, biz muammoni to'liq tushunishimiz kerak. React'ning 18-versiyasidan oldin, renderlash sinxron va to'xtatib bo'lmaydigan jarayon edi. Bitta qatorli yo'lni tasavvur qiling: bir marta mashina (render) kirgandan so'ng, u oxiriga yetmaguncha boshqa mashina o'ta olmaydi. React shunday ishlagan.

Klassik stsenariyni ko'rib chiqaylik: mahsulotlarning qidiriladigan ro'yxati. Foydalanuvchi qidiruv maydoniga yozadi va uning ostidagi minglab elementlardan iborat ro'yxat ularning kiritishiga qarab filtrlanadi.

Oddiy (va sekin) amalga oshirish

React 18'dan oldingi dunyoda yoki konkurent xususiyatlardan foydalanmasdan kod qanday ko'rinishi mumkinligi:

Komponent tuzilishi:

Fayl: SearchPage.js

import React, { useState } from 'react'; import ProductList from './ProductList'; import { generateProducts } from './data'; // katta massiv yaratadigan funksiya const allProducts = generateProducts(20000); // Keling, 20 000 ta mahsulotni tasavvur qilamiz function SearchPage() { const [query, setQuery] = useState(''); const filteredProducts = allProducts.filter(product => { return product.name.toLowerCase().includes(query.toLowerCase()); }); function handleChange(e) { setQuery(e.target.value); } return (


  );
}

export default SearchPage;

Nima uchun bu sekin ishlaydi?

Foydalanuvchining harakatini kuzatib boraylik:

Foydalanuvchi bir harf, masalan, 'a' yozadi.
onChange hodisasi ishga tushib, handleChange ni chaqiradi.
setQuery('a') chaqiriladi. Bu SearchPage komponentini qayta renderlashni rejalashtiradi.
React qayta renderlashni boshlaydi.
Renderlash ichida const filteredProducts = allProducts.filter(...) qatori bajariladi. Bu eng qimmat qism. 20 000 ta elementdan iborat massivni hatto oddiy 'includes' tekshiruvi bilan filtrlash ham vaqt talab etadi.
Bu filtrlash sodir bo'layotganda, brauzerning asosiy oqimi to'liq band bo'ladi. U yangi foydalanuvchi kiritishini qayta ishlay olmaydi, kiritish maydonini vizual ravishda yangilay olmaydi va boshqa hech qanday JavaScript'ni ishga tushira olmaydi. UI bloklangan.
Filtrlash tugagandan so'ng, React ProductList komponentini renderlashga o'tadi, bu o'zi minglab DOM tugunlarini renderlayotgan bo'lsa, og'ir operatsiya bo'lishi mumkin.
Nihoyat, barcha bu ishlardan so'ng, DOM yangilanadi. Foydalanuvchi kiritish maydonida 'a' harfi paydo bo'lganini va ro'yxat yangilanganini ko'radi.

Agar foydalanuvchi tez yozsa — aytaylik, "apple" — bu butun bloklash jarayoni 'a' uchun, keyin 'ap', 'app', 'appl' va 'apple' uchun sodir bo'ladi. Natijada kiritish maydoni qotib, foydalanuvchi yozishiga yetib olishga qiynaladigan sezilarli kechikish yuzaga keladi. Bu, ayniqsa, dunyoning ko'p qismlarida keng tarqalgan kam quvvatli qurilmalarda yomon foydalanuvchi tajribasidir.

React 18'ning konkurentligi bilan tanishuv

React 18 konkurentlikni joriy etish orqali bu paradigmani tubdan o'zgartiradi. Konkurentlik parallellik (bir vaqtning o'zida bir nechta ishni bajarish) bilan bir xil emas. Aksincha, bu React'ning renderlashni to'xtatib turish, davom ettirish yoki bekor qilish qobiliyatidir. Bitta qatorli yo'lda endi o'tish qatorlari va harakat nazoratchisi bor.

Konkurentlik bilan React yangilanishlarni ikki turga ajratishi mumkin:

Shoshilinch yangilanishlar: Bular kiritish maydoniga yozish, tugmani bosish yoki slayderni sudrash kabi bir zumda sezilishi kerak bo'lgan narsalar. Foydalanuvchi darhol javob kutadi.
O'tish yangilanishlari: Bular UI'ni bir ko'rinishdan boshqasiga o'tkazishi mumkin bo'lgan yangilanishlar. Ularning paydo bo'lishi uchun bir lahza vaqt ketsa, maqbuldir. Ro'yxatni filtrlash yoki yangi kontentni yuklash klassik misollardir.

React endi shoshilinch bo'lmagan "o'tish" renderlashini boshlashi va agar yanada shoshilinch yangilanish (masalan, boshqa klaviatura bosilishi) kelsa, uzoq davom etadigan renderlashni to'xtatib turishi, avval shoshilinchini bajarishi va keyin o'z ishini davom ettirishi mumkin. Bu UI'ning har doim interaktiv bo'lishini ta'minlaydi. useDeferredValue hook'i bu yangi kuchdan foydalanishning asosiy vositalaridan biridir.

`useDeferredValue` nima? Batafsil tushuntirish

Aslida, useDeferredValue bu sizning komponentingizdagi ma'lum bir qiymat shoshilinch emasligini React'ga aytish imkonini beruvchi hook'dir. U qiymatni qabul qiladi va shoshilinch yangilanishlar sodir bo'layotgan bo'lsa, "orqada qoladigan" o'sha qiymatning yangi nusxasini qaytaradi.

Sintaksis

Hook'dan foydalanish nihoyatda oddiy:

import { useDeferredValue } from 'react'; const deferredValue = useDeferredValue(value);

Shu xolos. Siz unga qiymat berasiz va u sizga o'sha qiymatning kechiktirilgan versiyasini beradi.

U qanday ishlaydi?

Keling, bu sehrni tushuntirib beraylik. Siz useDeferredValue(query) dan foydalanganingizda, React quyidagilarni amalga oshiradi:

Boshlang'ich renderlash: Birinchi renderlashda deferredQuery boshlang'ich query bilan bir xil bo'ladi.
Shoshilinch yangilanish sodir bo'ladi: Foydalanuvchi yangi belgi yozadi. query holati 'a' dan 'ap' ga yangilanadi.
Yuqori ustuvorlikdagi render: React darhol qayta renderlashni ishga tushiradi. Ushbu birinchi, shoshilinch qayta renderlash paytida, useDeferredValue shoshilinch yangilanish jarayonida ekanligini biladi. Shuning uchun u hali ham oldingi qiymatni, ya'ni 'a' ni qaytaradi. Sizning komponentingiz tezda qayta renderlanadi, chunki kiritish maydonining qiymati (holatdan) 'ap' ga aylanadi, lekin UI'ning deferredQuery ga bog'liq bo'lgan qismi (sekin ro'yxat) hali ham eski qiymatdan foydalanadi va qayta hisoblanishi shart emas. UI sezgir bo'lib qoladi.
Past ustuvorlikdagi render: Shoshilinch renderlash tugashi bilan, React fonda ikkinchi, shoshilinch bo'lmagan qayta renderlashni boshlaydi. *Bu* renderlashda useDeferredValue yangi qiymatni, 'ap' ni qaytaradi. Bu fondagi renderlash qimmat filtrlash operatsiyasini ishga tushiradigan narsadir.
To'xtatib turish imkoniyati: Mana asosiy qism. Agar foydalanuvchi 'ap' uchun past ustuvorlikdagi renderlash hali davom etayotganda boshqa harf ('app') yozsa, React o'sha fondagi renderlashni bekor qiladi va qaytadan boshlaydi. U yangi shoshilinch yangilanishga ('app') ustunlik beradi va keyin eng so'nggi kechiktirilgan qiymat bilan yangi fondagi renderlashni rejalashtiradi.

Bu qimmat ish har doim eng so'nggi ma'lumotlar ustida bajarilishini va u hech qachon foydalanuvchining yangi ma'lumot kiritishiga to'sqinlik qilmasligini ta'minlaydi. Bu murakkab qo'lda debouncing yoki throttling mantiqisiz og'ir hisob-kitoblarni pastroq ustuvorlikka qo'yishning kuchli usuli.

Amaliy qo'llash: Sekin qidiruvimizni tuzatish

Keling, oldingi misolimizni useDeferredValue yordamida qayta ishlab, uni amalda ko'raylik.

Fayl: SearchPage.js (Optimallashtirilgan)

import React, { useState, useDeferredValue, useMemo } from 'react'; import ProductList from './ProductList'; import { generateProducts } from './data'; const allProducts = generateProducts(20000); // Ro'yxatni ko'rsatish uchun komponent, unumdorlik uchun memoizatsiya qilingan const MemoizedProductList = React.memo(ProductList); function SearchPage() { const [query, setQuery] = useState(''); // 1. 'query' qiymatini kechiktiramiz. Bu qiymat 'query' holatidan orqada qoladi. const deferredQuery = useDeferredValue(query); // 2. Qimmat filtratsiya endi deferredQuery tomonidan boshqariladi. // Qo'shimcha optimallashtirish uchun buni useMemo'ga o'rab qo'yamiz. const filteredProducts = useMemo(() => { console.log('Filtrlanmoqda:', deferredQuery); return allProducts.filter(product => { return product.name.toLowerCase().includes(deferredQuery.toLowerCase()); }); }, [deferredQuery]); // Faqat deferredQuery o'zgarganda qayta hisoblanadi function handleChange(e) { // Ushbu holat yangilanishi shoshilinch va darhol qayta ishlanadi setQuery(e.target.value); } return (


      {/* 3. Kiritish maydoni yuqori ustuvorlikdagi 'query' holati bilan boshqariladi. U bir zumda ishlaydi. */}
      
      
      {/* 4. Ro'yxat kechiktirilgan, past ustuvorlikdagi yangilanish natijasi yordamida renderlanadi. */}


  );
}

export default SearchPage;

Foydalanuvchi tajribasidagi o'zgarish

Ushbu oddiy o'zgarish bilan foydalanuvchi tajribasi o'zgaradi:

Foydalanuvchi kiritish maydoniga yozadi va matn bir zumda, hech qanday qotishlarsiz paydo bo'ladi. Buning sababi, kiritish maydonining value xususiyati to'g'ridan-to'g'ri query holatiga bog'langan bo'lib, bu shoshilinch yangilanishdir.
Quyidagi mahsulotlar ro'yxati yetib olishi uchun bir lahza vaqt ketishi mumkin, lekin uning renderlash jarayoni hech qachon kiritish maydonini bloklamaydi.
Agar foydalanuvchi tez yozsa, ro'yxat faqat oxirida yakuniy qidiruv so'zi bilan bir marta yangilanishi mumkin, chunki React oraliq, eskirgan fondagi renderlashlarni bekor qiladi.

Ilova endi sezilarli darajada tezroq va professionalroq his etiladi.

`useDeferredValue` va `useTransition`: Farqi nimada?

Bu konkurent React'ni o'rganayotgan dasturchilar uchun eng keng tarqalgan chalkashlik nuqtalaridan biridir. Ham useDeferredValue, ham useTransition yangilanishlarni shoshilinch emas deb belgilash uchun ishlatiladi, ammo ular turli vaziyatlarda qo'llaniladi.

Asosiy farq: nazorat sizning qo'lingizda qayerda?

`useTransition`

Siz useTransition'dan holat yangilanishini ishga tushiradigan kodni nazorat qila olganingizda foydalanasiz. U sizga holat yangilanishingizni o'rash uchun odatda startTransition deb nomlanuvchi funksiyani beradi.

const [isPending, startTransition] = useTransition(); function handleChange(e) { const nextValue = e.target.value; // Shoshilinch qismni darhol yangilang setInputValue(nextValue); // Sekin yangilanishni startTransition'ga o'rang startTransition(() => { setSearchQuery(nextValue); }); }

Qachon ishlatish kerak: Holatni o'zingiz o'rnatayotganingizda va setState chaqiruvini o'rab olishingiz mumkin bo'lganda.
Asosiy xususiyati: isPending mantiqiy bayrog'ini taqdim etadi. Bu o'tish jarayoni amalga oshirilayotganda yuklanish spinnerlari yoki boshqa fikr-mulohazalarni ko'rsatish uchun juda foydali.

`useDeferredValue`

Siz useDeferredValue'dan qiymatni yangilaydigan kodni nazorat qila olmaganingizda foydalanasiz. Bu ko'pincha qiymat props'lardan, ota komponentdan yoki uchinchi tomon kutubxonasi tomonidan taqdim etilgan boshqa hook'dan kelganda sodir bo'ladi.

function SlowList({ valueFromParent }) { // Biz valueFromParent qanday o'rnatilishini nazorat qilmaymiz. // Biz uni shunchaki qabul qilamiz va unga asoslanib renderlashni kechiktirmoqchimiz. const deferredValue = useDeferredValue(valueFromParent); // ... komponentning sekin qismini renderlash uchun deferredValue'dan foydalaning }

Qachon ishlatish kerak: Sizda faqat yakuniy qiymat bo'lganda va uni o'rnatgan kodni o'rab ololmaganingizda.
Asosiy xususiyati: Ko'proq "reaktiv" yondashuv. U shunchaki qiymatning o'zgarishiga, u qayerdan kelganidan qat'i nazar, reaksiya bildiradi. U o'rnatilgan isPending bayrog'ini taqdim etmaydi, lekin siz uni osongina o'zingiz yaratishingiz mumkin.

Taqqoslash xulosasi

Xususiyat	`useTransition`	`useDeferredValue`
Nimani o'rab oladi	Holatni yangilash funksiyasi (masalan, `startTransition(() => setState(...))`)	Qiymat (masalan, `useDeferredValue(myValue)`)
Nazorat nuqtasi	Yangilanish uchun hodisa ishlovchisi yoki trigger'ni nazorat qilganingizda.	Qiymatni (masalan, props orqali) olganingizda va uning manbasini nazorat qila olmaganingizda.
Yuklanish holati	O'rnatilgan `isPending` mantiqiy qiymatini taqdim etadi.	O'rnatilgan bayroq yo'q, lekin `const isStale = originalValue !== deferredValue;` yordamida yaratilishi mumkin.
O'xshatish	Siz dispetcherssiz, qaysi poyezd (holat yangilanishi) sekin yo'ldan ketishini hal qilasiz.	Siz stansiya boshlig'isiz, poyezdda kelgan qiymatni ko'rib, uni asosiy tabloda ko'rsatishdan oldin bir muddat stansiyada ushlab turishga qaror qilasiz.

Ilg'or qo'llash holatlari va patternlar

Oddiy ro'yxatni filtrlashdan tashqari, useDeferredValue murakkab foydalanuvchi interfeyslarini yaratish uchun bir nechta kuchli patternlarni ochib beradi.

Pattern 1: Fikr-mulohaza sifatida "Eskirgan" UI'ni ko'rsatish

Hech qanday vizual fikr-mulohazasiz biroz kechikish bilan yangilanadigan UI foydalanuvchiga xatolikdek tuyulishi mumkin. Ular o'zlarining kiritishlari qayd etilganmi, deb o'ylashlari mumkin. Ajoyib pattern - bu ma'lumotlar yangilanayotganini ko'rsatuvchi nozik bir ishora berishdir.

Bunga asl qiymatni kechiktirilgan qiymat bilan solishtirish orqali erishish mumkin. Agar ular farq qilsa, bu fonda renderlash kutilayotganini anglatadi.

function SearchPage() { const [query, setQuery] = useState(''); const deferredQuery = useDeferredValue(query); // Bu mantiqiy qiymat ro'yxat kiritishdan orqada qolayotganini bildiradi const isStale = query !== deferredQuery; const filteredProducts = useMemo(() => { // ... deferredQuery yordamida qimmat filtrlash }, [deferredQuery]); return (


       setQuery(e.target.value)} />


  );
}

Ushbu misolda, foydalanuvchi yozishi bilan isStale true bo'ladi. Ro'yxat biroz xiralashadi, bu uning yangilanish arafasida ekanligini ko'rsatadi. Kechiktirilgan renderlash tugagach, query va deferredQuery yana tenglashadi, isStale false bo'ladi va ro'yxat yangi ma'lumotlar bilan to'liq shaffoflikka qaytadi. Bu useTransition'dagi isPending bayrog'ining ekvivalentidir.

Pattern 2: Grafiklar va vizualizatsiyalardagi yangilanishlarni kechiktirish

Sana oralig'i uchun foydalanuvchi tomonidan boshqariladigan slayderga asoslanib qayta renderlanadigan geografik xarita yoki moliyaviy grafik kabi murakkab ma'lumotlar vizualizatsiyasini tasavvur qiling. Agar grafik har bir piksel harakatida qayta renderlansa, slayderni sudrash juda sekin bo'lishi mumkin.

Slayderning qiymatini kechiktirish orqali siz slayder tutqichining o'zi silliq va sezgir bo'lib qolishini ta'minlashingiz mumkin, og'ir grafik komponenti esa fonda chiroyli tarzda qayta renderlanadi.

function ChartDashboard() { const [year, setYear] = useState(2023); const deferredYear = useDeferredValue(year); // HeavyChart - bu qimmat hisob-kitoblarni bajaradigan memoizatsiya qilingan komponent // U faqat deferredYear qiymati o'zgarganda qayta renderlanadi. const chartData = useMemo(() => computeChartData(deferredYear), [deferredYear]); return (


       setYear(parseInt(e.target.value, 10))}
      />
      Tanlangan yil: {year}


  );
}

Eng yaxshi amaliyotlar va keng tarqalgan xatolar

useDeferredValue kuchli bo'lishiga qaramay, undan oqilona foydalanish kerak. Mana, amal qilish kerak bo'lgan ba'zi asosiy eng yaxshi amaliyotlar:

Avval profillang, keyin optimallashtiring: useDeferredValue'ni hamma joyga qo'shib chiqmang. Haqiqiy unumdorlik muammolarini aniqlash uchun React DevTools Profiler'dan foydalaning. Bu hook aynan qayta renderlash haqiqatan ham sekin va yomon foydalanuvchi tajribasiga sabab bo'layotgan vaziyatlar uchun mo'ljallangan.
Kechiktirilgan komponentni har doim memoizatsiya qiling: Qiymatni kechiktirishning asosiy afzalligi sekin komponentni keraksiz qayta renderlashdan saqlanishdir. Bu afzallik sekin komponent React.memo bilan o'ralganida to'liq amalga oshiriladi. Bu uning faqat props'lari (jumladan, kechiktirilgan qiymat) haqiqatdan ham o'zgarganda qayta renderlanishini ta'minlaydi, kechiktirilgan qiymat hali eski bo'lgan dastlabki yuqori ustuvorlikdagi renderlash paytida emas.
Foydalanuvchiga fikr-mulohaza taqdim eting: "Eskirgan UI" patternida muhokama qilinganidek, hech qachon UI'ning biror vizual ishorasiz kechikish bilan yangilanishiga yo'l qo'ymang. Fikr-mulohaza yo'qligi asl kechikishdan ko'ra ko'proq chalkashlikka olib kelishi mumkin.
Kiritish maydonining qiymatini o'zini kechiktirmang: Keng tarqalgan xato - bu kiritish maydonini boshqaradigan qiymatni kechiktirishga harakat qilishdir. Kiritish maydonining value prop'i har doim bir zumda sezilishini ta'minlash uchun yuqori ustuvorlikdagi holatga bog'liq bo'lishi kerak. Siz sekin komponentga uzatilayotgan qiymatni kechiktirasiz.
`timeoutMs` opsiyasini tushuning (Ehtiyotkorlik bilan foydalaning): useDeferredValue ixtiyoriy ikkinchi argument sifatida timeout qabul qiladi: useDeferredValue(value, { timeoutMs: 500 }). Bu React'ga qiymatni qancha maksimal vaqt kechiktirishi kerakligini aytadi. Bu ba'zi hollarda foydali bo'lishi mumkin bo'lgan ilg'or xususiyatdir, lekin umuman olganda, vaqtni React'ning o'zi boshqarishiga qo'yib bergan ma'qul, chunki u qurilma imkoniyatlari uchun optimallashtirilgan.

Global foydalanuvchi tajribasiga (UX) ta'siri

useDeferredValue kabi vositalarni qabul qilish shunchaki texnik optimallashtirish emas; bu global auditoriya uchun yaxshiroq, inklyuzivroq foydalanuvchi tajribasiga sodiqlikdir.

Qurilmalar tengligi: Dasturchilar ko'pincha yuqori darajadagi kompyuterlarda ishlaydilar. Yangi noutbukda tez ishlaydigan UI eski, kam quvvatli mobil telefonda ishlamasligi mumkin, bu esa dunyo aholisining muhim qismi uchun asosiy internet qurilmasidir. Bloklanmaydigan renderlash ilovangizni kengroq turdagi qurilmalarda yanada chidamli va unumli qiladi.
Yaxshilangan maxsus imkoniyatlar: Muzlab qoladigan UI ekran o'quvchilari va boshqa yordamchi texnologiyalar foydalanuvchilari uchun ayniqsa qiyin bo'lishi mumkin. Asosiy oqimni bo'sh saqlash bu vositalarning muammosiz ishlashini davom ettirishini ta'minlaydi, barcha foydalanuvchilar uchun ishonchliroq va kamroq asabiylashtiradigan tajriba taqdim etadi.
Yaxshilangan idrok etiladigan unumdorlik: Psixologiya foydalanuvchi tajribasida katta rol o'ynaydi. Kiritishga darhol javob beradigan interfeys, hatto ekranning ba'zi qismlari yangilanishi uchun bir lahza vaqt ketsa ham, zamonaviy, ishonchli va yaxshi ishlangan his etiladi. Bu idrok etilgan tezlik foydalanuvchi ishonchi va qoniqishini oshiradi.

Xulosa

React'ning useDeferredValue hook'i unumdorlikni optimallashtirishga yondashuvimizdagi paradigma o'zgarishidir. Debouncing va throttling kabi qo'lda va ko'pincha murakkab usullarga tayanish o'rniga, biz endi React'ga UI'mizning qaysi qismlari kamroq muhim ekanligini deklarativ tarzda aytishimiz mumkin, bu esa unga renderlash ishlarini ancha aqlliroq va foydalanuvchiga qulayroq tarzda rejalashtirish imkonini beradi.

Konkurentlikning asosiy tamoyillarini tushunib, qachon useDeferredValue va qachon useTransition'dan foydalanishni bilib, memoizatsiya va foydalanuvchi fikr-mulohazasi kabi eng yaxshi amaliyotlarni qo'llash orqali siz UI qotishini yo'q qilishingiz va nafaqat funksional, balki foydalanish yoqimli bo'lgan ilovalar yaratishingiz mumkin. Raqobatbardosh global bozorda tez, sezgir va qulay foydalanuvchi tajribasini taqdim etish eng muhim xususiyatdir va useDeferredValue bunga erishish uchun arsenalingizdagi eng kuchli vositalardan biridir.