<Profiler>

<Profiler id="App" onRender={onRender}>
  <App />
</Profiler>

• রেফারেন্স
  • <Profiler>
  • onRender কলব্যাক
• ব্যবহার
  • প্রোগামেটিকালি রেন্ডারিং পারফরম্যান্সের পরিমাপ
  • অ্যাপ্লিকেশনের বিভিন্ন অংশের পরিমাপ

রেফারেন্স

<Profiler>

কম্পোনেন্ট ট্রিয়ের রেন্ডারিং পারফরম্যান্স পরিমাপ করার জন্য একে <Profiler> এর মধ্যে wrap করুন।

<Profiler id="App" onRender={onRender}>
  <App />
</Profiler>

Props

• id: একটা স্ট্রিং যেটা আপনি UI এর যে অংশ পরিমাপ করতে চান সেটাকে চিহ্নিত করতে ব্যবহৃত হয়।
• onRender: এটা একটা onRender কলব্যাক যেটাকে প্রতিবার প্রোফাইল হতে থাকা ট্রিয়ের মধ্যকার কম্পোনেন্ট আপডেট হলে React কল করে। কী রেন্ডার হল এবং কেমন সময় লাগল এই তথ্যটা সে পায়।

সতর্কতা

• প্রোফাইলিং কিছু অতিরক্ত কাজ বাড়ায়, তাই এটা প্রোডাকশন বিল্ডে স্বাভাবিকভাবে বন্ধ থাকে। প্রোডাকশন প্রোফাইলিং করতে, আপনাকে প্রোফাইলিং সক্রিয় আছে এমন একটি বিশেষ প্রোডাকশন বিল্ড চালু করতে হবে।

onRender কলব্যাক

React onRender কে কল করবে যেখানে কী রেন্ডার হয়েছিল সেই তথ্য থাকবে।

function onRender(id, phase, actualDuration, baseDuration, startTime, commitTime) {
  // Aggregate or log render timings...
}

প্যারামিটার

• id: <Profiler> ট্রিয়ের স্ট্রিং id প্রপ যা মাত্র কমিট করেছে। এটা আপনাকে জানায় যে ট্রিয়ের কোন অংশ কমিট করেছে যদি আপনি একাধিক প্রোফাইলার ব্যবহার করে থাকেন।
• phase: "mount", "update" অথবা "nested-update"। এটা আপনাকে জানায় যে ট্রি কি এই প্রথম মাউন্ট হল নাকি prop, state বা hook এর পরিবর্তনের কারণে পরিবর্তিত হয়েছে।
• actualDuration: বর্তমান আপডেটে <Profiler> এবং এর উত্তরসূরিদের রেন্ডার করতে যত মিলিসেকেন্ড খরচ হয়েছে সেই সংখ্যাটা। এটা নির্দেশ করে সাবট্রি মেমোইজেশন কতটা ভালভাবে ব্যবহার করতে পারছে (উদাহরণস্বরূপঃ memo এবং useMemo)। সব ঠিকঠাক থাকলে এই মানটা প্রথম মাউন্টের পর থেকে উল্লেখজনকভাবে কমে যাবার কথা কারণ, উত্তরসূরিদের অনেকেরই পুনরায় রেন্ডার তখনই হবে যখন তাদের কোন prop এর পরিবর্তন হয়।
• baseDuration: এই সংখ্যাটা বোঝায় যে কোন অপটিমাইজেশন ছাড়া পুরো <Profiler> সাবট্রি আবার রেন্ডার করার জন্য আনুমানিক কত মিলিসেকেন্ড লাগবে। সর্বশেষ রেন্ডারের জন্য ট্রিয়ের প্রতিটি কম্পোনেন্টে যে সময় লেগেছিল সেটা থেকে এই সংখ্যাটা হিসেব করা হয়। এই মানটা নির্দেশ করে রেন্ডারিং এর জন্য সবচেয়ে বেশি কত সময় লাগতে পারে (উদাহরণস্বরূপঃ একদম প্রাথমিক মাউন্ট বা মেমোইজেশন ছাড়া মাউন্টের সময়)। এর সাথে actualDuration তুলনা করে আপনি বুঝতে পারবেন মেমোইজেশন কাজ করছে কি না।
• startTime: একটা সাংখ্যিক টাইমস্ট্যাম্প যা নির্দেশ করে কখন React বর্তমান আপডেট শুরু করেছিল।
• endTime: একটা সাংখ্যিক টাইমস্ট্যাম্প যা নির্দেশ করে কখন React বর্তমান আপডেট commit করেছে। এই মানটা একটা কমিটে সব প্রোফাইলের সাথে শেয়ার করা হয়। যা তাদের প্রয়োজনে গ্রুপ হবার সুযোগ দেয়।

ব্যবহার

প্রোগামেটিকালি রেন্ডারিং পারফরম্যান্সের পরিমাপ

একটা React ট্রিয়ের রেন্ডারিং পারফরম্যান্স পরিমাপ করার জন্য একে <Profiler> কম্পোনেন্ট দিয়ে wrap করে ফেলুন।

<App>
  <Profiler id="Sidebar" onRender={onRender}>
    <Sidebar />
  </Profiler>
  <PageContent />
</App>

এর দুটি প্রপ প্রয়োজন হয়ঃ একটা id (স্ট্রিং) এবং একটি onRender কলব্যাক (ফাংশন) which React calls any time a component within the tree “commits” an update.

অ্যাপ্লিকেশনের বিভিন্ন অংশের পরিমাপ

অ্যাপ্লিকেশনের বিভিন্ন অংশের পরিমাপের জন্য আপনি একাধিক <Profiler> ব্যবহার করতে পারেনঃ

<App>
  <Profiler id="Sidebar" onRender={onRender}>
    <Sidebar />
  </Profiler>
  <Profiler id="Content" onRender={onRender}>
    <Content />
  </Profiler>
</App>

আপনি <Profiler> কম্পোনেন্টগুলো নেস্টও করতে পারেনঃ

<App>
  <Profiler id="Sidebar" onRender={onRender}>
    <Sidebar />
  </Profiler>
  <Profiler id="Content" onRender={onRender}>
    <Content>
      <Profiler id="Editor" onRender={onRender}>
        <Editor />
      </Profiler>
      <Preview />
    </Content>
  </Profiler>
</App>

যদি <Profiler> একটা হালকা কম্পোনেন্ট, এটা শুধুমাত্র তখনি ব্যবহার করা উচিত যখন প্রয়োজন পড়ছে। প্রতি বার ব্যবহারে অ্যাপের CPU এবং Memory এর উপরে অতিরিক্ত কিছু চাপ পড়ে।