IAdblockPlus

General notes

이 인터페이스는 애드블록 플러스와 통합하고 싶은 확장 프로그램에서 사용됩니다. 그것은 애드블록 플러스로부터 정보를 가져오거나 또 다른 확장 프로그램에 의해 업데이트될 "특별한" 구독 필터를 추가하게 해줍니다.

if ("@adblockplus.org/abp/public;1" in Components.classes)
{
  var abpURL = Components.classes["@adblockplus.org/abp/public;1"]
                         .getService(Components.interfaces.nsIURI);
  var AdblockPlus = Components.utils.import(abpURL.spec, null).AdblockPlus;
  alert(AdblockPlus.subscriptionCount);
}
else
{
  // Adblock Plus is not installed
}

Methods and properties


void addPatterns ( arrayof wstring patterns )

사용자가 정의한 필터 목록으로 패턴 추가

Version:
0.7.2.3 and higher
Arguments:
patterns: 추가될 필터 패턴의 목록

AString getInstalledVersion ( )

설치된 애드블록 플러스 확장 프로그램의 버전을 검색하십시오. 이것은 확장 프로그램 관리자 또는 InstallTrigger에 의해 보고된 버전 번호이거나 모질라 스위트 또는 시몽키에서 후자가 사용되면 올바르지 않을지도 모릅니다.

Returns:
애드블록 플러스 버전, 예시 0.7.0.1

IAdblockPlusSubscription getSubscription ( AString id )

식별자에 의해 구독 필터 검색

Arguments:
id: 구독 필터 식별자 (이것은 일반적인 구독 필터를 위한 구독 필터의 URL입니다.)
Returns:
요청된 구독 필터 또는 null은 제공된 인덱스가 올바르지 않을 때

IAdblockPlusSubscription getSubscriptionAt ( PRInt32 index )

필터 목록에서 그것의 위치(포지션)에 의해 구독 필터 검색

Arguments:
index: 필터 목록에서 구독 필터의 위치를 백지 상태로
Returns:
요청된 구독 필터 또는 null은 제공된 인덱스가 올바르지 않을 때

boolean removeExternalSubscription ( AString id )

외부 구독 필터의 제거

Arguments:
id: 구독 필터 식별자 (외부 구독 필터의 경우 이것은 어떠한 모든 문자열이 될 수 있음)
Returns:
true는 구독 필터가 제거되었을 때이고, false는 그러한 구독 필터가 존재하지 않거나 구독 필터가 외부적으로 관리되지 않을 때입니다.

void removePatterns ( arrayof wstring patterns )

사용자가 정의한 필터 목록에서 패턴 제거

Version:
0.7.2.3 and higher
Arguments:
patterns: 제거될 필터 패턴의 목록

readonly PRInt32 subscriptionCount

필터 목록에서 구독 필터의 수 (특별한 구독 필터를 포함함)


wstring updateExternalSubscription ( AString id, AUTF8String title, arrayof wstring patterns )

외부 구독 필터를 업데이트하십시오 (또는 현재 그러한 구독 필터가 존재하지 않는다면 그것을 생성하십시오). 그러한 구독 필터는 애드블록 플러스에 의해 업데이트되지 않을 것입니다. 대신에 그것을 업데이트하고, 일단 구독 필터를 제거의 원인이 되는 이 메서드를 호출하는 확장 기능이 더 이상 필요하지 않습니다.

애드블록 플러스 1.3 이상 : 외부 구독 필터는 다른 구독 필터와 함께 더 이상 저장되지 않을 것입니다. updateExternalSubscription() 메서드는 브라우저가 구독 필터를 복원하기 위해 시작할 때마다 호출될 필요가 있습니다. 이것은 사용자가 그것을 관리하는 확장 기능을 제거한다면 필터 목록에서 오래된 외부 구독를 유지하지 않게 하기 위함입니다.

또한 애드블록 플러스 1.3 이전에는 이 메서드는 구독 필터가 작성되었는지를 가리키는 불 방식으로 리턴됨. 구독 필터의 작성은 더 이상 실패할 수 없음

Arguments:
id: 구독 필터 식별자 (외부 구독 필터의 경우 이것은 모든 문자열이 될 수 있음)
title: 새로운 구독 필터가 생성되면 사용될 구독 필터 이름. 구독 필터가 이미 존재한다면 이 파라미터는 무시됩니다.
patterns: 구독 필터가 포함해야 할 필터 패턴의 목록
Returns:
효과적인 구독 필터 식별자 (id 파라미터로 식별되지 않음)