maotoumao/MusicFree · warning

toast.failToImportMusic

Error message

toast.failToImportMusic

What it means

This warning toast is shown when importing a single music item via a plugin yields no usable result. After the user enters a URL/text in the SimpleInput panel, the code awaits `plugin.methods.importMusicItem(text)`; if the resolved value is falsy (null/undefined/empty), it warns 'failToImportMusic'. The plugin itself is expected to resolve a shared link into an IMusicItem; a falsy return means the plugin could not resolve it.

Source

Thrown at src/pages/setting/settingTypes/pluginSetting/components/pluginItem.tsx:140

                            text,
                        );
                        if (result) {
                            showDialog("SimpleDialog", {
                                title: t("pluginSetting.pluginItem.options.importDialogTitle"),
                                content: t("pluginSetting.pluginItem.options.importMusicDialogContent", {
                                    name: result.title,
                                }),
                                onOk() {
                                    showPanel("AddToMusicSheet", {
                                        musicItem: result,
                                        newSheetDefaultName: t("pluginSetting.pluginItem.options.importMusicToSheetName", {
                                            name: plugin.name,
                                        }),
                                    });
                                },
                            });
                        } else {
                            Toast.warn(t("toast.failToImportMusic"));
                        }
                    },
                });
            },
            show: !!plugin.supportedMethods.has("importMusicItem"),
        },
        {
            title: t("pluginSetting.pluginItem.options.importSheet"),
            icon: "arrow-right-end-on-rectangle",
            onPress() {
                showPanel("SimpleInput", {
                    title: t("pluginSetting.pluginItem.options.importSheet"),
                    placeholder: t("pluginSetting.pluginItem.options.importSheetPlaceHolder"),
                    hints: plugin.instance.hints?.importMusicSheet,
                    maxLength: 1000,
                    async onOk(text, closePanel) {
                        Toast.success(t("toast.importing"));
                        closePanel();

View on GitHub (pinned to d118b18b3d)

Solutions

1. Verify the pasted URL matches the formats documented in the plugin's `hints.importMusicItem` (shown as panel hints) and re-enter it.
2. Check network connectivity and retry — remote resolution inside the plugin may have failed silently.
3. Update the plugin to its latest version; older versions break when the source service changes its share-link format or API.
4. If the plugin requires auth, set its user variables (userVariables panel) with valid cookies/tokens.

Example fix

// before
const result = await plugin.methods.importMusicItem(text);
if (result) { ... } else {
    Toast.warn(t("toast.failToImportMusic"));
}
// after
let result;
try {
    result = await plugin.methods.importMusicItem(text);
} catch (e: any) {
    Toast.warn(e?.message ?? t("toast.failToImportMusic"));
    return;
}
if (result && result.id) { ... } else {
    Toast.warn(t("toast.failToImportMusic"));
}

const result = await plugin.methods.importMusicItem(text);
if (!result || typeof result !== "object" || !result.id || !result.title) {
    Toast.warn(t("toast.failToImportMusic"));
    return;
}

function isMusicItem(x: unknown): x is IMusicItem {
    return !!x && typeof x === "object" && typeof (x as any).id !== "undefined" && typeof (x as any).title === "string";
}

try {
    const result = await plugin.methods.importMusicItem(text);
    if (!isMusicItem(result)) throw new Error("invalid result");
    // proceed
} catch (e: any) {
    Toast.warn(e?.message ?? t("toast.failToImportMusic"));
}

When it happens

Trigger: Submitting the import-music panel with text that the plugin's `importMusicItem` cannot resolve: an unsupported URL/host, a private or deleted track, an invalid share-code format, or the plugin returning null on any internal error. Also note any rejection here is unhandled (no try/catch around the await), so only falsy results reach this toast.

Common situations: Pasting a link from a music service the plugin doesn't support; sharing an expired or region-locked link; network failure inside the plugin causing it to return null; plugin's user variables (e.g. cookies/tokens) missing or expired; typos in a manually entered song ID.

Related errors

• toast.failToImportSheet
• 无法识别此插件
• panel.importMusicSheet.invalidLink
• 搜索结果为空
• mediakey不完整

AI-assisted analysis of maotoumao/MusicFree@d118b18b3d (2026-08-30). Data as JSON: /api/errors/ee1d53ab88b278ff. Report an issue: GitHub.