كائن Compilation

يحتوي كائن Compilation على كثير من الدوال والـ hooks. في هذه الصفحة نعرض الدوال والخصائص المتاحة عليه.

دوال كائن compilation

getStats

function

ترجع كائن Stats الخاص بالـ compilation الحالي.

addModule

function (module, callback)

تضيف module إلى compilation الحالي.

Parameters:

• module - الـ module المراد إضافته.
• callback - callback تُستدعى بعد إضافة module.

getModule

function (module)

تجلب module من compilation باستخدام المعرّف الخاص به.

Parameters:

• module - الـ module المراد جلبه. يستخرج compilation المعرّف من module باستخدام الدالة module.identifier().

findModule

function (module)

تحاول البحث عن module باستخدام المعرّف الخاص به.

Parameters:

• module - الـ module المراد البحث عنه. يستخرج compilation المعرّف من module باستخدام الدالة module.identifier().

buildModule

function (module, optional, origin, dependencies)

تبني module المحدد.

Parameters:

• module - الـ module المراد بناؤه.
• optional - علامة اختيارية.
• origin - الـ module الأصلي الذي طلب بناء هذا module.
• dependencies - dependencies اختيارية للـ module المراد بناؤه.

processModuleDependencies

function (module, callback)

تعالج dependencies الخاصة بالـ module المحدد.

Parameters:

• module - الـ module الذي ستُعالج dependencies الخاصة به.
• callback - دالة تُستدعى بعد انتهاء معالجة dependencies الخاصة بالـ module.

addEntry

function (context, entry, name, callback)

تضيف entry إلى compilation.

Parameters:

• context - مسار context الخاص بالـ entry.
• entry - اعتماد entry.
• name - اسم entry.
• callback - دالة تُستدعى عند انتهاء addEntry.

rebuildModule

function (module, thisCallback)

تشغّل إعادة بناء للـ module.

Parameters:

• module - الـ module المراد إعادة بنائه.
• thisCallback - دالة تُستدعى عند انتهاء إعادة بناء module.

finish

function (callback)

تنهي compilation وتستدعي callback المحددة.

Parameters:

• callback - دالة تُستدعى بعد انتهاء compilation.

seal

function (callback)

تعمل seal للـ compilation.

Parameters:

• callback - دالة تُستدعى بعد عمل seal للـ compilation.

unseal

function

تلغي seal الخاص بالـ compilation.

Parameters:

• callback - دالة تُستدعى بعد إلغاء seal للـ compilation.

reportDependencyErrorsAndWarnings

function (module, blocks)

تضيف أخطاء وتحذيرات module المحدد إلى أخطاء وتحذيرات compilation.

Parameters:

• module - الـ module الذي سيتم الإبلاغ عن أخطائه وتحذيراته.
• blocks - مجموعة dependency blocks سيتم الإبلاغ منها.

addChunkInGroup

function (groupOptions, module, loc, request)

تضيف module إلى chunk group موجود، أو تنشئ chunk group جديدًا. ترجع chunkGroup.

Parameters:

• groupOptions - خيارات chunk group.
• module - module يشير إلى chunk group.
• loc - المكان الذي تمت منه الإشارة إلى chunk group داخل module.
• request - request الذي تمت منه الإشارة إلى chunk group.

addChunk

function (name)

تنشئ chunk جديدًا وتضيفه إلى compilation.chunks. ترجع ذلك chunk.

Parameters:

• name - اسم chunk.

assignDepth

function (module)

تعيّن depth للـ module المحدد ولـ dependency blocks الخاصة به بشكل متكرر.

Parameters:

• module - الـ module المراد تعيين depth له.

getDependencyReference

function (module, dependency)

ترجع reference الخاص بالـ dependency من module محدد.

Parameters:

• module - الـ module المعني.
• dependency - الـ dependency المراد جلب reference له.

processDependenciesBlocksForChunkGroups

function (inputChunkGroups)

تنشئ graph خاصًا بـ Chunk من graph الخاص بـ Module. تتم العملية على مرحلتين. في المرحلة الأولى، يتم المرور على module graph وبناء chunks graph أساسي داخل chunkDependencies. في المرحلة الثانية، يتم المرور على كل طريق ممكن داخل chunk graph الأساسي وتتبع modules المتاحة. أثناء المرور، تربط processDependenciesBlocksForChunkGroups بين chunks وبعضها، وبين Blocks وChunks. وتتوقف عن المرور عندما تكون كل modules الخاصة بـ chunk متاحة بالفعل، ولا تربط chunks غير ضرورية.

Parameters:

• inputChunkGroups - chunk groups التي ستتم معالجتها.

removeReasonsOfDependencyBlock

function (module, block)

تزيل علاقة module مع dependency block.

Parameters:

• module - علاقة module المراد إزالتها.
• block - dependency block.

patchChunksAfterReasonRemoval

function (module, chunk)

تعدّل الروابط بين module وchunk بعد إزالة أسباب dependency. تُستدعى تلقائيًا بواسطة removeReasonsOfDependencyBlock.

Parameters:

• module - الـ module المراد تعديل رابطه.
• chunk - الـ chunk المراد تعديل رابطه.

removeChunkFromDependencies

function (block, chunk)

تزيل chunk محددًا من dependency block module ومن chunks بعد إزالة أسباب dependency. تُستدعى تلقائيًا بواسطة removeReasonsOfDependencyBlock.

Parameters:

• block - رابط block الخاص بـ Chunk.
• chunk - الـ chunk المراد إزالته من dependencies.

sortItemsWithChunkIds

function

summarizeDependencies

function

createHash

function

createModuleAssets

function

createChunkAssets

function

getPath

function (filename, data)

ترجع المسار بعد تطبيق قيم القوالب داخله.

Parameters:

• filename - يُستخدم للحصول على مسار asset مع hash.
• data - كائن البيانات.

getPathWithInfo

function (filename, data)

ترجع المسار بعد تطبيق القيم، مع معلومات asset.

Parameters:

• filename - يُستخدم للحصول على مسار asset مع hash.
• data - كائن البيانات.

createChildCompiler

function (name, outputOptions, plugins)

تسمح بتشغيل instance أخرى من webpack داخل webpack، لكن كـ child بإعدادات وخيارات مختلفة. تنسخ كل hooks وplugins من parent أو top-level compiler، ثم تنشئ instance فرعية من Compiler. ترجع كائن Compiler الذي تم إنشاؤه.

Parameters:

• name - اسم Compiler الفرعي.
• outputOptions - كائن خيارات output.
• plugins - webpack plugins التي سيتم تطبيقها.

checkConstraints

function

emitAsset

function (file, source, assetInfo = {})

Parameters:

• file - اسم ملف asset.
• source - مصدر asset.
• assetInfo - معلومات إضافية عن asset.

updateAsset

function (file, newSourceOrFunction, assetInfoUpdateOrFunction)

Parameters:

• file - اسم ملف asset.
• newSourceOrFunction - مصدر asset الجديد، أو دالة تحول المصدر القديم إلى جديد.
• assetInfoUpdateOrFunction - معلومات asset الجديدة، أو دالة تحول المعلومات القديمة إلى جديدة.

deleteAsset

function (file)

Parameters:

• file - اسم ملف asset.

getAssets

function

ترجع array تحتوي على كل assets الموجودة تحت compilation الحالي.

getAsset

function (name)

Parameters:

• name - اسم asset المطلوب إرجاعه.