Загрузка зависимой библиотеки в SuiteScript

На чтение 3 мин Опубликовано 18.09.2024

Вопрос или проблема

У меня есть клиентский скрипт, который использует библиотеку Leaflet следующим образом:

define(['./modules/leaflet/leaflet','N/search', 'N/runtime'],

    function(L, search, runtime) {

Это работает хорошо, и я могу использовать такие вещи, как L.layerGroup(). Проблема, с которой я столкнулся, заключается в том, что существует несколько библиотек, созданных для Leaflet. Все они говорят, что просто нужно загружать файл js после файла Leaflet.

Так что если я добавлю, скажем, библиотеку MarkerCluster следующим образом:

define(['./modules/leaflet/leaflet','N/search', 'N/runtime', './modules/MarkerCluster/leaflet.markercluster'],

Я получаю ошибку о том, что внутри библиотеки MarkerCluster L не определён.

Есть ли у вас мысли, как мне это решить? Я много играл с requireConfig.json, изменяя пути, шимы и зависимости, но ничего не сработало.

Ответ или решение

Для разрешения проблемы с загрузкой зависимостей существуют несколько подходов, которые вы можете использовать, чтобы правильно интегрировать библиотеку MarkerCluster в вашу клиентскую скрипт на SuiteScript.

Когда вы используете RequireJS для загрузки модулей, важно помнить, что каждая библиотека, которая зависит от глобальных переменных (например, L в случае Leaflet), должна иметь доступ к этой переменной. В вашем случае библиотека MarkerCluster не видит L, так как она загружается в свой собственный контекст, где L не определён.

Для решения этой проблемы, выполните следующие шаги:

Определите зависимости в require.config: Убедитесь, что вы правильно настроили вашу конфигурацию RequireJS для указания зависимостей. Вам нужно будет указать, что библиотека leaflet.markercluster зависит от leaflet.
Используйте shim: Если библиотека MarkerCluster не поддерживает модульный подход, и вы не можете использовать define, то вам нужно воспользоваться параметром shim в require.config. Это позволяет вам определить зависимости для непотоковых библиотек.

Пример конфигурации в require.config может выглядеть так:

require.config({
    paths: {
        'leaflet': './modules/leaflet/leaflet',
        'leaflet.markercluster': './modules/MarkerCluster/leaflet.markercluster'
    },
    shim: {
        'leaflet': {
            exports: 'L'
        },
        'leaflet.markercluster': {
            deps: ['leaflet'],
            exports: 'L.MarkerClusterGroup'
        }
    }
});

Загрузите библиотеки в клиентском скрипте: После настройки конфигурации, вы можете импортировать библиотеки в вашем скрипте следующим образом:

define(['leaflet', 'N/search', 'N/runtime', 'leaflet.markercluster'],
    function(L, search, runtime) {
        // Здесь вы можете использовать L и L.MarkerClusterGroup
        var markers = L.markerClusterGroup();
        // Ваш остальной код...
    });

Проверьте порядок загрузки: Убедитесь, что вы загружаете Leaflet перед MarkerCluster, так как библиотека MarkerCluster зависит от Leaflet.

Следуя этим шагам, вы сможете успешно интегрировать библиотеку MarkerCluster с библиотекой Leaflet в вашем проекте на SuiteScript, избежав ошибок и обеспечив корректную работу библиотеки.