feat: getClashNodeNames 增加默认节点

docs/guide/custom-template.md

@@ -295,11 +295,12 @@ ss://[email protected]:1234/?group=subscribe_demo#%F0%9F%87%AD%F0%9F
 
 ### getClashNodeNames
 
-`getClashNodeNames(nodeList, filter?, prependNodeNames?)`
+`getClashNodeNames(nodeList, filter?, prependNodeNames?, defaultNodeNames?)`
 
 :::tip 提示
 - `filter` 为可选参数
 - `prependNodeNames` 为可选参数。可以通过这个参数在过滤结果前加入自定义节点名
+- `defaultNodeNames` 为可选参数。可以通过这个参数实现在过滤结果为空的情况下，使用默认的自定义节点名
 - [Clash 规则维护指南](/guide/client/clash.md)
 :::
 
@@ -317,6 +318,12 @@ getClashNodeNames(nodeList, netflixFilter);
 getClashNodeNames(nodeList, netflixFilter, ['测试节点']);
 ```
 
+需要过滤 Netflix 节点，如果没有 Netflix 相关节点，则使用 `默认节点`
+
+```js
+getClashNodeNames(nodeList, netflixFilter, [], ['默认节点']);
+```
+
 ### getLoonNodes
 
 `getLoonNodes(nodeList, filter?)`

src/utils/__tests__/clash.test.ts

@@ -39,10 +39,16 @@ test('getClashNodeNames', async (t) => {
     nodeNameList,
     (nodeConfig) => nodeConfig.nodeName !== 'Test Node 3',
   )
-
+  const result4 = clash.getClashNodeNames(
+    nodeNameList,
+    (nodeConfig) => nodeConfig.nodeName === 'Test Node 4',
+    [],
+    ['DIRECT'],
+  )
   t.deepEqual(result1, ['Test Node 1', 'Test Node 3'])
   t.deepEqual(result2, ['TEST', 'Test Node 1', 'Test Node 3'])
   t.deepEqual(result3, ['Test Node 1'])
+  t.deepEqual(result4, ['DIRECT'])
 
   t.deepEqual(
     clash.getClashNodeNames([

src/utils/clash.ts

@@ -33,6 +33,7 @@ export const getClashNodeNames = function (
   list: ReadonlyArray<PossibleNodeConfigType>,
   filter?: NodeFilterType | SortedNodeFilterType,
   prependNodeNames?: ReadonlyArray<string>,
+  defaultNodeNames?: ReadonlyArray<string>,
 ): ReadonlyArray<string> {
   // istanbul ignore next
   if (arguments.length === 2 && typeof filter === 'undefined') {
@@ -47,6 +48,10 @@ export const getClashNodeNames = function (
 
   result = result.concat(getClashNodes(list, filter).map((item) => item.name))
 
+  if (result.length === 0 && defaultNodeNames) {
+    result = result.concat(defaultNodeNames)
+  }
+
   return result
 }